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TERMS AND CONDITIONS OF SALE AND LICENSE OF TANDY COMPUTER EQUIPMENT AND SOFTWARE PURCHASED 
FROM RADIO SHACK COMPANY-OWNED COMPUTER CENTERS, RETAIL STORES AND RADIO SHACK FRANCHISEES OR 
DEALERS AT THEIR AUTHORIZED LOCATIONS 


LIMITED WARRANTY 
CUSTOMER OBLIGATIONS 


A. CUSTOMER assumes full responsibility that this computer hardware purchased (the ‘‘Equipment’’), and any copies of software included with the 
Equipment or licensed separately (the ‘‘Software’’) meets the specifications, capacity, capabilities, versatility, and other requirements of CUSTOMER. 

B. CUSTOMER assumes full responsibility for the condition and effectiveness of the operating environment in which the Equipment and Software are to 
function, and for its installation. 


LIMITED WARRANTIES AND CONDITIONS OF SALE 


A. Fora period of ninety (90) calendar days from the date of the Radio Shack sales document received upon purchase of the Equipment. RADIO SHACK 
warrants to the original CUSTOMER that the Equipment and the medium upon which the Software is stored is free from manufacturing defects. This 
warranty is only applicable to purchases of Tandy Equipment by the original customer from Radio Shack company-owned computer centers, 
retail stores, and Radio Shack franchisees and dealers at their authorized locations. The warranty is void if the Equipment’s case or cabinet has 
been opened, or if the Equipment or Software has been subjected to improper or abnormal use. If a manufacturing defect is discovered during the 
stated warranty period, the defective Equipment must be returned to a Radio Shack Computer Center, a Radio Shack retail store, a participating 
Radio Shack franchisee or a participating Radio Shack dealer for repair, along with a copy of the sales document or lease agreement. The original 
CUSTOMER’S sole and exclusive remedy in the event of a defect is limited to the correction of the defect by repair, replacement, or refund of the 
purchase price, at RADIO SHACK’S election and sole expense. RADIO SHACK has no obligation to replace or repair expendable items. 

B. RADIO SHACK makes no warranty as to the design, capability, capacity, or suitability for use of the Software, except as provided in this paragraph. 
Software is licensed on an ‘‘AS IS’’ basis, without warranty. The original CUSTOMER’S exclusive remedy, in the event of a Software manufacturing 
defect, is its repair or replacement within thirty (30) calendar days of the date of the Radio Shack sales document received upon license of the 
Software. The defective Software shall be returned to a Radio Shack Computer Center, a Radio Shack retail store, a participating Radio Shack 
franchisee or Radio Shack dealer along with the sales document. 

C. Except as provided herein no employee, agent, franchisee, dealer or other person is authorized to give any warranties of any nature on behalf of 
RADIO SHACK. 

D. EXCEPT AS PROVIDED HEREIN, RADIO SHACK MAKES NO EXPRESS WARRANTIES, AND ANY IMPLIED WARRANTY OF MERCHANTABILITY OR 
FITNESS FOR A PARTICULAR PURPOSE IS LIMITED IN ITS DURATION TO THE DURATION OF THE WRITTEN LIMITED WARRANTIES SET FORTH 
HEREIN. 

E. Some states do not allow limitations on how long an implied warranty lasts, so the above limitation(s) may not apply to CUSTOMER. 


LIMITATION OF LIABILITY 


A. EXCEPT AS PROVIDED HEREIN, RADIO SHACK SHALL HAVE NO LIABILITY OR RESPONSIBILITY TO CUSTOMER OR ANY OTHER PERSON OR 
ENTITY WITH RESPECT TO ANY LIABILITY, LOSS OR DAMAGE CAUSED OR ALLEGED TO BE CAUSED DIRECTLY OR INDIRECTLY BY 
“EQUIPMENT” OR “SOFTWARE” SOLD, LEASED, LICENSED OR FURNISHED BY RADIO SHACK, INCLUDING, BUT NOT LIMITED TO, ANY 
INTERRUPTION OF SERVICE, LOSS OF BUSINESS OR ANTICIPATORY PROFITS OR CONSEQUENTIAL DAMAGES RESULTING FROM THE USE OR 
OPERATION OF THE “EQUIPMENT” OR “SOFTWARE.” IN NO EVENT SHALL RADIO SHACK BE LIABLE FOR LOSS OF PROFITS, OR ANY 
INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY BREACH OF THIS WARRANTY OR IN ANY MANNER ARISING OUT OF 
OR CONNECTED WITH THE SALE, LEASE, LICENSE, USE OR ANTICIPATED USE OF THE ‘EQUIPMENT’ OR “SOFTWARE.” 

NOTWITHSTANDING THE ABOVE LIMITATIONS AND WARRANTIES, RADIO SHACK’S LIABILITY HEREUNDER FOR DAMAGES INCURRED BY 
CUSTOMER OR OTHERS SHALL NOT EXCEED THE AMOUNT PAID BY CUSTOMER FOR THE PARTICULAR “EQUIPMENT” OR “SOFTWARE’’ 
INVOLVED. 

B. RADIO SHACK shall not be liable for any damages caused by delay in delivering or furnishing Equipment and/or Software. 

C. No action arising out of any claimed breach of this Warranty or transactions under this Warranty may be brought more than two (2) years after the 
cause of action has accrued or more than four (4) years after the date of the Radio Shack sales document for the Equipment or Software, whichever 
first occurs. 

D. Some states do not allow the limitation or exclusion of incidental or consequential damages, so the above limitation(s) or exclusion(s) may not apply 
to CUSTOMER. 


SOFTWARE LICENSE 


RADIO SHACK grants to CUSTOMER a non-exclusive, paid-up license to use the TANDY Software on one computer, subject to the following provisions: 
. Except as otherwise provided in this Software License, applicable copyright laws shall apply to the Software. 

B. Title to the medium on which the Software is recorded (cassette and/or diskette) or stored (ROM) is transferred to CUSTOMER, but not title to the 
Software. 

C. CUSTOMER may use Software on a multiuser or network system only if either, the Software is expressly labeled to be for use on a multiuser or 
network system, or one copy of this software is purchased for each node or terminal on which Software is to be used simultaneously. 

D. CUSTOMER shall not use, make, manufacture, or reproduce copies of Software except for use on one computer and as is specifically provided in 
this Software License. Customer is expressly prohibited from disassembling the Software. 

E. CUSTOMER is permitted to make additional copies of the Software only for backup or archival purposes or if additional copies are required in the 
operation of one computer with the Software, but only to the extent the Software allows a backup copy to be made. However, for TRSDOS Software, 
CUSTOMER is permitted to make a limited number of additional copies for CUSTOMER’S own use. 

F. CUSTOMER may resell or distribute unmodified copies of the Software provided CUSTOMER has purchased one copy of the Software for each one 
sold or distributed. The provisions of this Software License shall also be applicable to third parties receiving copies of the Software from 
CUSTOMER. 

G. All copyright notices shall be retained on all copies of the Software. 


APPLICABILITY OF WARRANTY 


A. The terms and conditions of this Warranty are applicable as between RADIO SHACK and CUSTOMER to either a sale of the Equipment and/or 
Software License to CUSTOMER or to a transaction whereby Radio Shack sells or conveys such Equipment to a third party for lease to CUSTOMER. 

B. The limitations of liability and Warranty provisions herein shall inure to the benefit of RADIO SHACK, the author, owner and or licensor of the 
Software and any manufacturer of the Equipment sold by Radio Shack. 


STATE LAW RIGHTS 


The warranties granted herein give the original CUSTOMER specific legal rights, and the original CUSTOMER may have other rights which vary from 
state to state. | 
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Information in this document is subject to change without notice and does not represent a com- 
mitment on the part of The Santa Cruz Operation, Inc. nor Microsoft Corporation. The software 
described in this document is furnished under a license agreement or nondisclosure agreement. 
The software may be used or copied only in accordance with the terms of the agreement. It is 
against the law to copy this software on magnetic tape, disk, or any other medium for any purpose 
other than the purchaser’s personal use. 


© 1983, 1984 Microsoft Corporation 
© 1984, 1985 The Santa Cruz Operation, Inc. 
Licensed to Tandy Corporation 


XENIX is a registered trademark of Microsoft Corporation. 
MS isa trademark of Microsoft Corporation. 
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Preface 


The complete XENIX Reference Manual is actually divided into six parts and distributed as indi- 
vidual reference sections in the various volumes of the XENIX Operating, Text Processing, and 
Development Systems. The following table lists the name, content, and location of each re- 
ference section. 


Section Description Volume 

C Commands — used with the XENIX Reference Manual 
XENIX Operating System. 

CT Text Processing Commands — _ Text Processing Guide 
used with the Text Processing 
System. 

CP Programming Commands — used Programmer’s Guide 


with the Development System. 


M Miscellaneous — information used XENIX Reference Manual 
for access to devices, system main- 
tenance, and communications. 


S System Calls and Library Rou- Programmer’s Reference 
tines — available for C and 
assembly language programming. 


F File Formats — description of | Programmer’s Reference 
various system files not defined in 
section M. 


In text, a given command, routine, or file is referred to by name and section. For example, the 
programming command “‘cc’’, which is described in the Programming Commands (CP) section, 
is listed as cc(CP) in the text. 


The alphabetized table of contents given on the following pages is a complete listing of all XENIX 
commands, system calls, library routines, and file formats. If you want to locate information 
about a specific item look in the indicated reference section. 


Alphabetized List 


Commands, Systems Calls, Library Routines, and File Formats 


BOGE ci ua ee a.out(F) 
I Ss oie ccd eneh Aen lon a641(S) 
MUTE 2c ccd ea abort(S) 
LT ae REN RO) SOURS COS RUREE Sree Sere Ctr abs(S) 
ROCESS Finance access(S) 
BOEU 3 cloiactutaeden clon verabeebaees acct(F) 
BRE ss cetesteeeeeee a acct(S) 
BOCCONI: cc wasawiicsavieteies acctcom(C) 
BCI os isec snare ch eoecanien accton(C) 
RO sie eats Sco trig(S) 
We ieee vi catasvasvawee naa auavta be nctewwiens acu(M) 
RO as ote ere adb(CP) 
C171) 1) SoS ae eee CPR RS OEE Ene admin(CP) 
RUE eed eae eeusaets alarm(S) 
OE See ae ae nee oe een ees aliases(M) 
RIRGCS ASN ics ccntcnevicie nck: aliases(M) 
RHASHASH «.0.:55sce0sseseriscineiss aliashash(M) 
BE so a dasscnniaa anata ar(CP) 
ERS Raa Ee rein an Mare aca eee ar(F) 
a Re ER SN ee eer as(CP) 
ROENE coacnaeee ascii(M) 
BECOME: atiticiotccics shaeaaes ctime(S) 
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BGM EIRIO ic cceccob te eereviseas asktime(C) 
BOSGEE oid can tivicasecteseincuasvavseencevors assert(S) 
PIR essere sn aereong hacnimeneennsents assign(C) 
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OME. fice teen whee trig(S) 
DBE eicct oe chcpasecetc neni atof(S) 
BIOL sxireieenieteacuhiarbeannneuk atof(S) 
MSIE | cincndeteatveossiiociveser al atacast cada atof(S) 
WUE Be icah ict a acta menln Aaeiaes at(C) 
WRENN oie ctidaenisens ennai macers at(C) 
IE 5 lh ninrcra catherine ces uomeniaateneas awk (C) 
DaCKOD A kniniiadiddcamieed backup(C) 
BMCRUDY 45.025 ech eukcet aves backup(F) 
badblkutil .......................... badblkutil(M) 
NONDED cata banner(C) 
DASEMAME ............ccccceeeeessseees basename(C) 
DG ic vasalisteeecre neiienteeen ies bc(C) 
tabi a Ure bdiff(C) 
Re eis amare eaew hei bncealecmwiuae eck bfs(C) 
Wil ah tiicu aie ac sbrk(S) 
DSGRION. cavdikiecasionantawerdixs bsearch(S) 
RR ac sscrira les fecdera oesesnac ee eakeies hypot(S) 
HED i525 Aa ce pases ee ee aan: cal(C) 
COIGNERS ol oiGnGes aie calendar(C) 
PAG a csccxesrnchvcesdtsnassentsateax veoudens malloc(S) 
| SOREN ERE ERE ON es Meee Seen cat(C) 
GR capacities cb(CP) 


oy NAR CREPE ete CRE Teen E ROT arene Sen ee cc(CP) 
| Here PLY RONSON Sir ROR St eh ARC Oe Te cd(C) 
OG 5 ssssnnce ceeds tensdeeucss omsanz Aazxaveewne nese: cd(M) 
COGS itisccsccieceess cdc(CP) 
CO ei aeiahiddicoencre alnanieuntens floor(S) 
"i | gi oR EP bt ie ene chdir(S) 
CURCEOW Sicctitsehcanenisieeue cw(CT) 
TOOK OU ors suck siateeecsicesese ead eqn(CT) 
CRG creck tocrstceecee checklist(F) 
CHOTD « cisccest ix ninco chgrp(C) 
CRIOU Soi aniahars chmod(C) 
CHIMOE chon iia chmod (S) 
CIN WEE 1:5 her iices ues eesendwioe chown(C) 
CHOW si vcaencenAdeaanus chown(S) 
HEGRE chet eestor chroot(C) 
CRIOOE Gesicacdacnnciae enn chroot(S) 
LCL 4 ce RRO Geer a ee AD chsize(S) 
SICRTODRE: 2 pisawcerroraiacanss-ene ferror(S) 
a (So eee OER ee ree close(S) 
CODY ticks tas ead et tea aseceede cmp(C) 
CO ae argent ies aa col(CT) 
COMMS Secreta ineiercosousn comb(CP) 
CORON oo Ais Reee tra ater epee comm(C) 
CONSOIE i ee, console(M) 
COOV isc ie ects copy(C) 
"EL 6 Ran ne ER RERUN) OEE AEE Se Ee NOE LOR core(F) 
OS cigs secon as uetcisadcetist invanevacevscumdioua. trig(S) 
COGN: Sects ote eee sinh(S) 
OW vicesadintvinse tia visinaci CW cp(C) 
CD 33 hrc eG cpio(C) 
CIO ions siedesonnesesaeivassax ne eane newereses cpio(F) 
CWE ccsccraumnanieigiiee cette cpp(CP) 
BEEGE Goole ee creat(S) 
CLOATISOND 50 sis5 beet rctcns creatsem(S) 
CEOT ch casocsonatokeunaaceds cref(CP) 
CEO peas elites Ge: cron(C) 
CPV heh ws enindare tae crypt(C) 
CUYD Eseries ea ea crypt(S) 
C5 Si cetices perce iccasnt cans ass ezreneae ints: csh(C) 
CSDNE a ciiwrrnionn ennimiatas csplit(C) 
ENS = cicairrriaaat ease venmuntgatertaiios ctags(CP) 
ClORNNE Ae ede ctermid(S) 
RNIN epee aes eae havea ctime(S) 
UR aera canta cape avec aenennaens cu(C) 
SES: ica sraineetsiea cess CLES (CO) 
CIS inc wen eee curses(S) 
CUNCTIE osc eater ntenian cuserid(S) 
CUE as cataditep eee aes cut(CT) 
OW picdiaciecse intssnextocasarcannuossuamarencnse cw(CT) 
CWRICOR casein ns na iicesacetiic cw(CT) 
daemon.mmn ..................666. daemon.mn(M) 
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TIE sos depsceseccticsestiatncs cies dbm(S) 
Wai aarti etccuns aes dc(C) 
OD idee eadeesete ri tati al dieaseten: dd(C) 
COASGON oc cciniiarorcer mien assign(C) 
GON sa default(M) 
GR OUITY ook schasdenstaareentesenasuancis defopen(S) 
COTO RE Ss eAisciviestiectsn cat defopen(S) 
a) ES DE ER A ETT SEE ERE eT dbm(S) 
TO hic eo ilicteaniedenasices, delta(CP) 
QOTON irises etecccteone deroff(CT) 
MONTE ied, uke creer devnm(C) 
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Oe Asie ace aanes ae dial(M) 
ECT RORE 6525 otis een asiestaninctors diction(CT) 
EE ic Achaea nike eae: diff(C) 
GES. ies oceisscts es diff3(C) 
GIN bee iiinstcccters diffmk(CT) 
BU ccarvicdesaccu es eiouPuxsieaaavieevere tise dir(F) 
COE oc cy diene aticneeates dircmp(C) 
| ae ee eee er Sere dirname(C) 
NGM sicitcsyenciescvceastcnspiceenieane disable(C) 
Oe cr ecitnienrinee heen du(C) 
CUMING skis dumpdir(C) 
GO sasrawaninecdatenniahecote dup(S) 
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ea Geach a ed(C) 
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PONG 22 ss Shei seutuavescivadinee ais grep(C) 
CIES: UL eiwhsnid cs enable(C) 
CHIVES dic ouaianaderacaks crypt(S) 
BINED sess vorsbcinieice tance cept a acame os end(S) 
CAGE ONE sn cicciccisccnnirnceaticnneexe getgrent(S) 
CUNDWENE nsicawktecrtees getpwent(S) 
BE eee actascnc costco env(C) 
CRN, i eresshisitrcetecnn econ environ(M) 
CONE atid arta tehatenctenunnee eqn(CT) 
COMPMCON: ios aiicilicisieicvcivneaceens eqn(CT) 
CEPBE OR ea iia as perror(S) 
CUO RE pis cticaceyscsvsnasreriendnrenreencs end(S) 
OR icc ancien asinhainoa ee ex(C) 
CROCE ie loaves exec(S) 
CROC ieee oes exec(S) 
REECE 5 oduct cavauuleu eats exec(S) 
PROCY VisiccontireeaitansthaWereticicns exec(S) 
oS | a PE eae ee a exec(S) 
PERCH oriiticseastiniie Seoniecenions exec(S) 
CRA avian siesta eas exit(S) 
PED id ac inoctaiancntuardas exp(S) 
CRUMNE shhcihivcsi Gal stints explain(CT) 
NIE can Gaspernscvcadcenbettnsannvenctuccersies expr(C) 
Te i Ginter aaa floor(S) 
FRCUON. coterinastivtinkineatharnke factor(C) 
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TRUSSES se Austin acdanes aliases(M) 
TARE ones suena es false(C) 
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SELOERAUN coco cetis ceareecscarcin eek getgrent(S) 
OREN hcszos eck Sehencssaegtadaivooves getlogin(S) 
POUOUE oo Bassani tvs getopt(C) 


PROG iisciiSe eo a getopt(S) 
REDNESS siiccetiaticnuisiccceannn getpass(S) 
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WORD os cies stidvcasemyial es tatiadnetnccent getpid(S) 
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TORING Aoi var rectatcciveeniartnt logname(C) 
OUR IRD ciao cincnsenoe setjmp(S) 
WOM: skvdiurtsctueisyacavatatuervocearaeeashernieds look(C) 
MAPUOE te deka ects es nee ap eceeccet lorder(CP) 
AB sere ee ees Ip(M) 
BASE sv cg apca ch opacuz ape antesete is couulawunsgeeees Ipr(C) 
OER OT OM CE O er re R RRC Re Is(C) 
IRORECI Fo icesae ee edad eaccaata hs lsearch(S) 
CGN eo nerncecuativantanticteatidr tavern ciers Iseek(S) 
Ee Tete Sepa ree rr eA Dene E rar ee 13tol(S) 
WERE a oh aida av eaw acre oes Ste aah m4(CP) 
MIRORING Sai ccczncicntsieessatees machine(M) 
GRR) ss piiSieistedesdush eeeoreensnceiess mail(C) 
WAEC sh aicasaniee make(CP) 
SAM OROY eeaveraeiiaeceeveres: makekey(M) 
TIMUNSOS: 555 ci sccecsasiccensisiate teak aliases(M) 
MIANIOE 5s ation etiam malloc(S) 
Ce) eee ORC Ree reer Ty enn ere man(CT) 
FORSTER iene veins master(F) 
PROUD Sicrsscchieceasins tenons mem(M) 
WROGG re oi ieorins ss Ruse mesg(C) 
MNOSSAGOS vccecicncwavermvviens messages(M) 
ACRE on oe, micnet(M) 
BSG, Si saeeeteanericrasstousAaiiuets mkdir(C) 
NLS ieee oc mkfs(C) 
RRO cies ciccrrA catenins mknod(C) 
PURTNOG 6.255 iene eeaveseasees mknod(S) 
11a | Sauna RC nee een rere mkstr(CP) 
MRCOG uasieln cadeieusar mktemp(S) 
BURSON acct edolinieiee mkuser(C) 
WOE csi contiauinseavcm sesame mm(CT) 
WINCHEER 60s tcd aes mmcheck(CT) 
WAIICINOCK sscsds cess seecsaviensatses checkmm(CT) 
WOME: os isla Macey tuete cal tiieuiedeematreaaes mmt(CT) 
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ORE inv ctaeeiote ae mnttab(F) 
BR aa sds Duspasne ssn esuneelb cna frexp(S) 
WIIIOE ei kcd hase ciavataiaciseess monitor(S) 
ORG eaieiiviess cures weed erro more(C) 
PROURE 5. Aether at mount (C) 
WIOUNL seis crioiadsticimu ae mount(S) 
BG SecA tasted Rear act tinder dow valeaneees mv(C) 
AG osiecs cin err nes nap(S) 
nbwaitsem ...................sseeeeceeees waitsem(S) 
COC cariyiisialessh tucatnsern ee ncheck(C) 
NOGIE sicicavcisiccissieisue ie ements eqn(CT) 
PU ss sicesecroen vase eevee paceesentsnecepiasene neqn(CT) 
MOU sii dusieoon ate onie netutil(C) 
NOW GED ci iiocecctissss Biden newgrp(C) 
ROW Saha ion news(C) 
BOE Geis oe dbm(S) 
OE ss rcitiaticcsicties wecatatiiseanes nice(C) 
FR arse teaentate ete nice(S) 
hciicie se gue eee nl(C) 
HE ics sp eet cee tuan ts eucvsaecty eagatieeass nlist(S) 
WN Scar oaricaner econ nm(CP) 
ORGY se oh a eee nohup(C) 
NEON og cksceitniis ones nroff{(CT) 
GUE Ai scast esas Metiseseienktie ees null(M) 
OEE. Shiba vevecicvaheeecavelearaties od(C) 
EE cx et var cot Careers open(S) 
ODRNSENY  2oaced hice aeetigk opensem(S) 
ROM aureus ee pack(C) 
WUROWNG Csi a cicavi axes extents passwd(C) 
BOSSI S rincicusr esiusaenss passwd(M) 
DASE <i sists rnc snaanes paste(CT) 
OE, Cae RE AY EA oer te AON pause(S) 
BME sacs ac euiuapenuriveuriaceiostnpeeeene ess pack(C) 
DOIN si Aisa etadiccsthakns popen(S) 
RET OE ctchensct Scone aeceee perror(S) 
BENE i ailetes tia an aunt haere ties pipe(S) 
ee RRM CREO Ra TEST oR Nn plock(S) 
BODEN: csjiecccirid cre earns popen(S) 
ON eo hee ieiad aire eels exp(S) 
BEE ica vec estesiacevveiciationn ee teerk eames pr(C) 
OIRO cic ierckausn aie prep(CT) 
TIRE od ater Vain aeons printf(S) 
WOT sues icivesccensbbeasuncmie aes Guede prof(CP) 
WEOUE 3 Asuiha cen oouncucgaeaees profil(S) 
DLOMC siGnncncsunieniaons profile(M) 
|, ROI ASE Soe OROe ee Pe anne A prs(CP) 
DE win Ricsicuniconci ar wieka eee Gas ps(C) 
WRG ob iste ada ieedetete ts pstat(C) 
DIFACE cuisinart area ts ptrace(S) 
5 SOO) a eae ORO aoe EEN RE ptx(CT) 
DROS Sauce nice niente iioteaaasaunds putc(S) 
RRC TIE 55.5c oases putc(S) 
putpwent .............. ce eeeeeeeee putpwent(S) 
PUES os paiet eset ranareeeeaneecta eeatens puts(S) 
OW tastccveniuhieiccetivunccspesneetints putc(S) 


DRSOH icitinnGacrinncdin pwadmin(C) 


BWCWRO chica ern pwcheck(C) 
WEE rs er hessiataldve aeach ha hesespcarsezinans pwd(C) 
SEG cesar teeceeerecdnsaentae qsort(S) 
SMa ae OA RC OT APD Oe quot(C) 
FAW ices Focus st vatneteec cians rand(S) 
CADRE hrc Aueiicits ines tecanan random(C) 
PRN Soishcinitiein epsomnaieouawe ranlib(CP) 
PRIOR. oe seni, ae ees ratfor(CP) 
ERD sceatsvheaivchssnndre rerauncne eens rcp(C) 
POC Ae ess acer rdchk(S) 
| Se aR OE APC EMR ceva oe read(S) 
FORNGE drdisatateit oan malloc(S) 
ho! Rg One eR one RO A Cer aR NO red(C) 
PESEMAD .crscieradiiareeens regcmp(CP) 
RORCIID 2s ontario eee regex(S) 
POROR sasicetd ots ai sckse aioe regex(S) 
OE ra restikicieensen ad ouisaepneres regexp(S) 
POUR coe ees remote(C) 
PESIOE ccs. ania eis restor(C) 
EWING cw ote ee. fseek(S) 
UE Sikes eat ene eee sced rm(C) 
TIED Sassen ees rmdel(CP) 
FIAGEE hore eens rmdir(C) 
FUMIGOE xocccnrsncaiaienkeiee rmuser(C) 
DEN Masisincas coteweahiuleettervons tite iveie serene rsh(C) 
ROE coke atie ace leeens sact(CP) 
SUE kao aceennteeieee sbrk(S) 
WOME is ccisoeddasisigeeeeenuens scanf(S) 
SCOSMIN naieiietaanusmusncs sccsdiff(CP) 
BORSH iias econ: sccsfile(F) 
SOME > siscieresticceniawnniuek sddate(C) 
| SOR ee ERE OR sdenter(S) 
OE oiceceincnnnrusiniee sdget(S) 
WEES ston: ce vnazcesde Nouvesd asx eunaniens sdgetv(S) 
GAUETE vveviasin Secu pave cates iootuceees sdiff(C) 
SEE o hie a ee sdenter(S) 
SWEET neice eda sdgetv(S) 
SOU. cicces diesen reas iaitecaereln sed(C) 
BEEONEE « 45-stsarsnrsccina tiers easieoee nee setbuf(S) 
BORG eit ected es setuid(S) 
SEAR EE csi ctarsrearenonsunune getgrent(S) 
SOUND ossiscascpiiecoriwansiniediodiens setjmp(S) 
SREB sans eitecrvientad cistern crypt(S) 
| ERY ROI PR SOE ERM RTO TT CI setmnt(C) 
i | | eC OnE te PRES Ee TSR ae setpgrp(S) 
SOIDWEBE: seccesncaciacdictesiscecinceves getpwent(S) 
SONG inti des dvciuaess settime(C) 
SEU ova avis ov raeesedicesncinesesss setuid(S) 
AEs ete socatinaace el ecsacee ena neneenk sh(C) 
SVAN soci vison cniereenmasien shutdn(S) 
SOW, oie doacieces shutdown(C) 
SIR cass enone tacos signal(S) 
SHISCUE enniciceienaomernenen sigsem(S) 
SH cient hen eae trig(S) 


BENIN vas sicksncshasvndss ei nanan ttaieoeees sinh(S) 
2 Sie ny Oe Se te OO Se tee size(CP) 
SICED eacireoeden rience oie tees sleep(C) 
SISO. crcvarcas wean sleep(S) 
BOGHRE ai hutitiarcccotawianiecestase soelim(CT) 
SOEE Actitic tad wieder te sort(C) 
SOON) cccenarcasissieiteespeiacuave cast spell(CT) 
SHON gece enasiae spell(CT) 
SCG ack cisions spell(CT) 
GPLIG: cs ssccchsadeaias sian ea vinniseeee spline(CP) 
SOU sicoiiicucimiamnsiouunnase split(C) 
SUPINE s.ccsscginsseccarnn aves printf(S) 
SEG orcas Sars creten inh pote einen exp(S) 
SPAM Fo ioas ar con ee cae rand(S) 
| | Ae Ce CEO RRR Stier oeepee ty ere scanf(S) 
SIN cess yn adavie xine enwencassthistso) ssignal(S) 
ek Ree Re eee Rene re ern Or ae ee stat(F) 
BERN ir is aR te gacineen onde os stat(S) 
EEG: Mi cat teas nee dig ieee stdio(S) 
GUINE oo di taccnerschsotieinetnmeeens stime(S) 
SIOTE cian as dbm(S) 
coo he | Ra RC ee RO RT ere string(S) 
SORE Liisa tease: string(S) 
SUCRE elas ouamrtiaiedarra es string(S) 
SECOe fa hancinderniir ams tenes string(S) 
SIECSON caiurawieguicimmnauas string(S) 
GEO ovate sau ta eewaew era venvnds string(S) 
SENOS eos ies Sik Gata aasins strings(CP) 
SIPIG Gu Soka nti aie oe strip(CP) 
SITIO A cnc aoe string(S) 
SUHCAL ohne string(S) 
RIPNOHID cic ininn bas eteiaes string(S) 
SEPA OY crcoicldmctencccdiase einen string(S) 
cL eee eae Ben oar eyesore er FOE string(S) 
SEPT OHE sei cerseseerce Gia string(S) 
SEPSDW ea dieastecdasisssear einen aaeoun anes string(S) 
SIFIOK ni ccleaner string(S) 
BEN ciaicc ian gastcormnede nce stty(C) 
SIVIC: Giese Men style(CT) 
| ate RDI err ORT RDA) ERTL CNE, Vahey Tre arc? su(C) 
VIG cht usecase ne cee nta ney: sum(C) 
GWA acnkcsuteusstowasu een swab(S) 
SUNG ici ae Goatees sync(C) 
SAO ce tetara cavern ncianapiieneen sync(S) 
SVS: CITUGE  sccidirsrircctesmrede perror(S) 
OES NONE oc) hearers: perror(S) 
SVSHAIDIW socssiniaceacrsceosnsiarsveas sysadmin(C) 
BUSUCNE ccc ccedo cme iua ins system(S) 
SUSIOTIIG, Gieccaimanns systemid(M) 
CANE oat icc sncpuke teenage ene tail(C) 
CAD aciinitisicen en Saas trig(S) 
CN fee hod ce ocictusesa tree ee aes sinh(S) 
GAP ints icleceia aise a ea tar(C) 
OL piers a ee ee tbl(CT) 
COG er icc kssnksh serene ene tee(C) 


ROI ao eakeudcin tetas kates eet term(M) 


LOPINCAD sce nwiineeres termcap(M) 
(CTR Ss cidiicommaiare terminals(M) 
(Sl cen cach test(C) 
Sco fs || Sent oan enE Re aC raT termcap(S) 
COONS cient cisccom avresertinctins termcap(S) 
CHOU coos csesincirmriatianiecacens termcap(S) 
ROUGE jocssisicn sees Gainers termcap(S) 
C2010 i civic ni emnnes termcap(S) 
CEN up loot hesitates time(CP) 
(iOS oie ie owas time(S) 
COS ccd sek eas edeaeo eee times(S) 
REN oes aoe Serssaccdiat eiseaneteis tmpfile(S) 
HADNOE scciiosscenneaees tmpnam(S) 
1OHBOH 66 sisetiaasicce as conv(S) 
COWHER ik AeA conv(S) 
(08 cc dk n eG tees top(M) 
COP MIERE citi ecscdadacerenten top(M) 
FOUN chs Wha tne touch(C) 
COUDDOT cccicnices ceparernuaaimens conv(S) 
CULL, hereon Oe ee renee nerve termcap(S) 
| Ga REE NE RE TEE EOE PAE At Sree eet ry eee nae tr(C) 
CRONE odrcadeces ciastanss meee troff(CT) 
PEE hoc hse aes true(C) 
(SOE en Scic Staines tset(C) 
1SOTE Fhe tsort(CP) 
HE orien ert tty(C) 
1S ksi ioe canis tty(M) 
(EVHATIE 5.5 he ttyname(S) 
CONS incites ek seers ttys(M) 
EPTIOS os Gasser tense entaneasenniaes encores types(F) 
RROD, oases Seca en ctime(S) 
ITE cio Ncevcenevromeesi ulimit (S) 
MRIS aan ce dane ater umask(C) 
GEILE IG, cia sacccacassncenteesia eeasetnean tees umask(S) 
MOET 5. ocdssiencsy teks msde umount (C) 
UOUNNE: accel eiseixces eccismmoconnes umount (S) 
QAM” phar iaveeres uname(C) 
RPM UNNE S re tbohol reel ative arexmnmnons uname(S) 
GIO 6. 5ch aacearna enemies unget (CP) 
WNGCLE doa nineicioo iene ungetc(S) 
UNG: oie rrannicee ans unig(C) 
MERITS elnctite cece cence: units (C) 
GBEBNEION 55, cooasasdesiseweeciecsansensodeas ten unlink(S) 
WNDACK Fkcieaiooa nies pack(C) 
DPS CE cassis scutes tases asesca tan ninatssneaets ustat(S) 
TING ies Kioccnb olteientenee utime(S) 
BEND saicccdussteesien hea utmp(M) 
HCMC RID aspen oe icidecen wo ateorsones uuclean(C) 
WOR oes otisescedrnscin caress uucp(C) 
MEOH oss sci cicrssnecuasanecrodieverstoenserse uucp(C) 
CROW 35s te Rak cinrtansaaie: uunow(C) 
SOARHG EE ars ancesh ser chiyiere aoa uusend(C) 
SIAL: sacha Mitieiate en toreasies uustat(C) 
HUSTED socscgiiedesaassaswnucieneterecss uusub(C) 
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REINER ais cchevete cones tieveesioscwasioe uuto(C) 
ES or Satire Gases uux(C) 
LET COE OPE encteee MON NES SUNN val(C) 
Re Ce ere Ae ESOT ert aE RE vi(C) 
fo WERE So Cer OAT eR en red vsh(C) 
SORA ee aA eR DORE AMD Re wait(C) 
WIE Sue ierte tte re ae wait(S) 
WRMISONE cos cesa sud ic etdeteareeattaats waitsem(S) 
|| ORE Sen NORE RNEERE UV, wall(C) 
WE iicces pein hao nes eeeea eo es we(C) 
WY a rctuteeah Rees eas what(C) 
WHEE = ihc porcine houston who(C) 
WOOO hint inc anaendtn whodo(C) 
Ly Se Sn en eS ee write(C) 
TN oii ean eee nance eee write(S) 
i Ce ee aon CA utmp(M) 
MAUR eases haute tenieiaecavse ates xargs(C) 
BORN S Ee srlacsacas tose vies ces a cuastencet aloo: xlist(S) 
MR EU bic saxmivncetvonecievommcintncneeds xref(CP) 
SIE peste leis eacass cosas arent Ste xstr(CP) 
GAP os scp uataiteriate ete dkeve eu Menerks bessel(S) 
WMT cattohothitcticsaumeaie das austen bessel(S) 
WRC ih an ee aca eat eens yacc(CP) 
MORE se uentinncucevastawebienas aimratecte: yes(C) 
AY aso soe cheavi rede e eaten Gaede bessel(S) 


commands (c) 


Contents 


Commands (C) 


intro 
acctcom 
accton 
asktime 
assign, deassign 
at, atq, atrm 
awk 
backup 
banner 
basename 
be 

bdiff 

bfs 

cal 
calendar 
cat 

cd 
chgerp 
chmod 
chown 
chroot 
cmp 
comm 
copy 

cp 

cpio 
cron 
crypt 
csh 
csplit 

cu 

cu.s3 
date 

dc 

dd 
devnm 
df 

diff 

diff 3 
dircmp 


Introduces XENIX commands. 

Searches for and prints process accounting files. 
Turns on accounting. 

Prompts for the correct time of day. 

Assigns and deassigns devices. 

Executes commands ata later time. 

Searches for and processes a pattern in a file. 
Performs incremental file system backup. 
Prints large letters. 

Removes directory names from pathnames. 
Invokes a calculator. 

Compares files too large for diff. 

Scans big files. 

Prints a calendar. 

Invokes a reminder service. 

Concatenates and displays files. 

Changes working directory. 

Changes group ID. 

Changes the access permissions of a file or directory. 
Changes owner ID. 

Changes root directory for command. 
Compares two files. 

Selects or rejects lines common to two sorted files. 
Copies groups of files. 

Copies files. 

Copies file archives in and out. 

Executes commands at specified times. 
Encodes and decodes files. 


Invokes a shell command interpreter with C-like syntax. 


Splits files according to context. 

Call up XENIX (Version 7). 

Call up XENIX (System 3). 

Prints and sets the date. 

Invokes an arbitrary precision calculator. 
Converts and copies a file. 

Identifies device name. 

Reports the number of free disk blocks. 
Compares two text files. 

Compares three files. 

Compares directories. 


dirname 

disable 

du 

dumpdir 

echo 

ed 

enable 

eny 

ex 

expr 

factor, primes 
false 

file 

find 

finger 

fsck 

getopt 

grep, egrep, fgrep 
grpcheck 
haltsys 

hd 

head 

id 
join 
kill 

| 

Ic 

line 

In 
logname 
look 
Ipr 

Is 

mail 
mesg 
mkdir 
mkfs 
mknod 
mkuser 
more 
mount 
mv 
ncheck 
netutil 
newgrp 
news 
nice 

nl 


Delivers directory part of pathname. 

Turns off terminals. 

Summarizes disk usage. 

Prints the names of files on a backup archive. 
Echoes arguments. 

Invokes the text editor. 

Turns on terminals. 

Sets environment for command execution. 
Invokes a text editor. 

Evaluates arguments as an expression. 
Factor a number, generate large primes. 
Returns with a nonzero exit value. 
Determines file type. 

Finds files. 

Finds information about users. 

Checks and repairs file systems. 

Parses command options. 

Searches a file for a pattern. 

Checks group file. 

Closes out the file systems and halts the CPU. 
Displays files in hexadecimal format. 

Prints the first few lines of a stream. 

Prints user and group IDs and names. 

Joins two relations. 

Terminates a process. 

Lists information about contents of directory. 
Lists directory contents in columns. 

Reads one line. 

Makes a link toa file. 

Gets login name. 

Finds lines in a sorted list. 

Sends files to the lineprinter queue for printing. 
Gives information about contents of directories. 
Sends, reads or disposes of mail. 

Permits or denies messages sent to a terminal. 
Makes a directory. 

Constructs a file system. 

Builds special files. 

Adds a login ID to the system. 

Views a file one screen full at a time. 

Mounts a file structure. 

Moves or renames files and directories. 
Generates names from inode numbers. 
Administers the XENIX network. 

Logs user in to a new group. 

Prints news items. 

Runs a command at a different priority. 
Adds line numbers to a file. 


nohup 
od 


pack, pcat, unpack 


passwd 
pr 

ps 

pstat 
pwadmin 
pwcheck 
pwd 
quot 
random 
rep 

red 
remote 
restore 
rm, rmdir 
rmdir 
rmuser 
rsh 
sddate 
sdiff 

sed 
setmnt 
settime 
sh 
shutdown 
sleep 
sort 
split 
stty 

su 

sum 
sync 
sysadmin 
tail 

tar 

tee 

test 
touch 

tr 

true 

tset 

tty 
umask 
umount 


Runs a command immune to hangups and quits. 
Displays files in octal format. 

Compresses and expands files. 

Changes login password. 

Prints files on the standard output. 

Reports process status. 

Reports system information. 

Performs password aging administration. 
Checks password file. 

Prints working directory name. 

Summarizes file system ownership. 

Generates a random number. 

Copies files across KENIX systems. 

Invokes a restricted version of ed(C). 

Executes commands on a remote XENIX system. 
Invokes incremental file system restorer. 
Removes files or directories. 

Removes directories. 

Removes a user from the system. 

Invokes a restricted shell (command interpreter). 
Prints and sets backup dates. 

Compares files side-by-side. 

Invokes the stream editor. 

Establishes /etc/mnttab table. 

Changes the access and modification dates of files. 
Invokes the shell command interpreter. 
Terminates all processing. 

Suspends execution for an interval. 

Sorts and merges files. 

Splits a file into pieces. 

Sets the options for a terminal. 

Makes the user super-user or another user. 
Calculates checksum and counts blocks in a file. 
Updates the super-block. 

Performs file system backups and restores files. 
Delivers the last part of a file. 

Archives files. 

Creates a tee ina pipe. 

Tests conditions. 

Updates access and modification times of a file. 
Translates characters. 

Returns with a zero exit value. 

Sets terminal modes. 

Gets the terminal’s name. 

Sets file-creation mode mask. 

Dismounts a file structure. 


uname 
uniq 

units 
uuclean 
uucp, uulog 
uunow 
uusend 
uustat 
uusub 
uuto, uupick 
uux 

vi 

vsh 

wait 

wall 

we 

what 

who 

whodo 
write 
xargs 

yes 


Prints the current XENIX name. 
Reports repeated lines in a file. 
Converts units. 

Clean-up the uucp spool directory. 
Copies files from XENIX to XENIX. 
Initiate a uucp sequence now. 

Send a file to a remote host. 

Uucp status inquiry and job control. 
Monitor uucp network. 

Public XENIX-to-XENIX file copy. 
Executes command on remote XENIX. 
Invokes a screen-oriented display editor. 
Invokes the visual shell. 

Awaits completion of background processes. 
Writes to all users. 

Counts lines, words and characters. 
Identifies files. 

Lists who is on the system. 

Determines who is doing what. 

Writes to another user. 

Constructs and executes commands. 
Prints string repeatedly. 
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Name 
c™ 


intro — Introduces XENIX commands. 


Description 


This section describes use of the individual commands available in the XENIX Timesharing System. 
Each individual command is labeled with either a C, a CP, or a CT for easy reference from other vo- 
lumes. The letter “C” stands for “command”. The letters “P” and “T” stand for commands that come 
with the optional XENIX Programming System and the XENIX Text Processing System, respectively. 
For example, the reference date(C) indicates a reference to a discussion of the date command in the C 
section; the reference cc(CP) indicates a reference to a discussion of the ce command in the XENIX 
Programmer’s System; and the reference spel//(CT) indicates a reference to a discussion of the spell 
command in the XENIX Text Processing System. The Text Processing and Programmer’s Systems are 
optional supplemental packages to the standard Timesharing System. 


The “M’” Miscellaneous section contains miscellaneous information including a great deal of system 
maintenance information. Other reference sections include the “S”’ System Services section and the “F” 
File Format section. Both these sections come as part of the Programmer’s Reference with the optional 
Software Development System. 


Syntax 


Unless otherwise noted, commands described in this section accept options and other arguments accor- 
ding to the following syntax: 


c™ name [option(s)] [cmdarg(s)] 
where: 
name Is the name of an executable file. 
option — noargletter(s) or, 
— argletter << >optarg 


where <> is optional whitespace. 


noargletter __Is a single letter representing an option without an argument. 


argletter Is a single letter representing an option requiring an argument. 
optarg Is an argument (character string) satisfying preceding argletter. 
cmdarg Is a pathname (or other command argument) not beginning with —. — by itself indicates 


the standard input. 


See Also 
getopt(C), getopt(S) 
Diagnostics 


Upon termination, each command returns 2 bytes of status, one supplied by the system and giving the 
cause for termination, and (in the case of “normal” termination) one supplied by the program (see 
co wait(S) and exit(S)). The former byte is 0 for normal termination; the latter is customarily 0 for suc- 
cessful execution and nonzero to indicate troubles such as erroneous parameters, bad or inaccessible 
data. It is called variously “exit code’, “exit status’, or “return code”, and is described only where 
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special conventions are involved. 


Notes 


Not all commands adhere to the syntax described here. 
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Name 


acctcom — Searches for and prints process accounting files. 


Syntax 


acctcom [[options][file]]... 


Description 


Acctcom reads file, the standard input, or /usr/adm/pacct, in the form described by acct(F) and writes 
selected records to the standard output. Each record represents the execution of one process. The 
output shows the COMMAND NAME, USER, TTYNAME, START TIME, END TIME, REAL (SEC), CPU 
(SEC), MEAN SIZE(K), and optionally, F (the fork /exec flag: 1 for fork without exec) and STAT (the 
system exit status). 


The command name is prepended with a # if it was executed with super-user privileges. If a process is 
not associated with a known terminal, a ? is printed in the TTYNAME field. 


If no files are specified, and if the standard input is associated with a terminal or /dev/null (as is the 
case when using & in the shell), /usr/adm/pacct is read, otherwise the standard input is read. 


If any file arguments are given, they are read in their respective order. Each file is normally read 
forward, i.e., in chronological order by process completion time. The file /usr/adm/pacct is usually the 
current file to be examined; a busy system may need several files, in which case all but the current file 
will be found in /usr/adm/pacct?. The options are: 


—b Reads backwards, showing latest commands first. 
=f Prints the fork /exec flag and system exit status columns in the output. 
—h Instead of mean memory size, shows the fraction of total available CPU time consumed by 


the process during its execution. This “hog factor” is computed as: 


(total CPU time) /(elapsed time). 


a | Prints columns containing the I/O counts in the output. 
=k Instead of memory size, shows total kcore-minutes. 

—m Shows mean core size (the default). 

—f Shows CPU factor (user time/(system-time + user-time).) 
if Shows separate system and user CPU times. 

se Excludes column headings from the output. 

—I line Shows only processes belonging to terminal /dev//ine. 


—u user Shows only processes belonging to user that may be specified by a user ID, a login name that 
is then converted to a user ID, a # which designates only those processes executed with 
super-user privileges, or ? which designates only those processes associated with unknown 
user IDs. 
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—g group Shows only processes belonging to group. The group may be designated by either the group 
ID or group name. 


—d mm/dd Any time arguments following this flag are assumed to occur on the given month and day, 
rather than during the last 24 hours. This is needed for looking at old files. 


—s time Shows only those processes that existed on or after time, given in the form Ar:min:sec. The 
ssec Or :min:sec may be omitted. 


—e time Shows only those processes that existed on or before time. Using the same time for both —s 
and —e shows the processes that existed at time. 


—n pattern Shows only commands matching pattern that may be a regular expression as in ed(C) ex- 
cept that + means one or more occurrences. 


—H factor Shows only processes that exceed factor, where factor is the “hog factor” as explained in op- 
tion —h above. 


—I number 
Shows driver processes transferring more characters than the cutoff number. 


—O time Shows only those processes with operating system CPU time that exceeds time. 


—C time Shows only those processes that exceed time (the total CPU time). 


Multiple options have the effect of a logical AND. 


Files 
/etc/passwd 


/usr/adm/pacct 


/etc/group 


See Also 


accton(C), ps(C), su(C), acct(S), acct(F), utmp(M) 


Notes 


Acctcom only reports on processes that have terminated; use ps(C) for active processes. 
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Name 


ACCTON (C) 


accton — Turns on accounting. 


Syntax 


accton [file] 


Description 


Accton turns on and off process accounting. If no file is given, then accounting is turned off. If file is 
given, it must be the name of an existing file, to which the kernel appends process accounting records. 
(see acct (S) and acct (F)). 


Files 
/etc/passwd 
/usr /lib/acct 
/usr/adm/pacct 


/usr/adm/wtmp 


See Also 


Used for login name to user ID conversions 
Holds many accounting commands 
Current process accounting file 


Login/logout history file 


acctcom(C), acct(S), acct(F), utmp(M) 
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Name 


asktime — Prompts for the correct time of day. 


Syntax 


/etc/asktime 


Description 


This command prompts for the time of day. You must enter a legal time according to the proper format 
as defined below: 


[[vy]mmdd|hhmm 


Here the first mm is the month number; dd is the day number in the month; hh is the hour number 
(24-hour system); the second mm is the minute number; yy is the last 2 digits of the year number and is 
optional. The current year is the default if no year is mentioned. 

Examples 


This example sets the new time, date, and year to “11:29 April 20, 1984”. 


Current system time is Wed Nov 3 14:36:23 PST 1982 
Enter time ([yymmdd]hhmm): 8404201129 


Diagnostics 
If you enter an illegal time, asktime prompts with: 


Try again: 


Notes 


Asktime is normally performed automatically by the system startup file /etc/re immediately after the 
system is booted. Although it may be executed at any time do so only when absolutely necessary. Do not 
change the date and time back and forth. Instead, shutdown the system and answer the initial date and 
time prompts during boot. The command is privileged, and can only be executed by the super-user. 


Systems which autoboot will invoke asktime automatically on reboot. On these system if you don’t enter 
a new time, or press return, within 10 minutes of invoking asktime the system will use the time value it 
has. 
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Name 


assign, deassign — Assigns and deassigns devices. 


Syntax 
assign [| —u | [ —v ] [ —d ] [ device ] ... 


deassign [ —u | [ —v ] [ device ] ... 


Description 


Assign attempts to assign device to the current user. The device argument must be an assignable device 
that is not currently assigned. An assign command without an argument prints a list of assignable dev- 
ices along with the name of the user to whom they are assigned. 


Deassign is used to “deassign” devices. Without any arguments, deassign will deassign all devices as- 
signed to the user. When arguments are given, an attempt is made to deassign each device given as an 
argument. 


Available options include: 


—d Performs the action of deassign. The —d option may be embedded in device names to assign some 
devices and deassign others. 


—y Gives verbose output. 
—u Suppresses assignment or deassignment, but performs error checking. 


The assign command will not assign any assignable devices if it cannot assign all of them. Deassign 
gives no diagnostic if the device cannot be deassigned. Devices may be automatically deassigned at lo- 
gout, but this is not guaranteed. Device names may be just the beginning of the device required. For 
example, 


assign fd 


should be used to assign all floppy disk devices. Raw versions of device will also be assigned, e.g., the 
raw floppy disk devices /dev/rfd? would be assigned in the above example. 


Note that in many installations the assignable devices such as floppy disks have general read and write 
access, so the assign command may not be necessary. This is particularly true on one-user systems. Dev- 
ices supposed to be assignable with this command should be owned by the user asg. The directory /dev 
should be owned by bin and have mode 755. The assign command (after checking for use by someone 
else) will then make the device owned by whoever invokes the command, without changing the access 
permissions. This allows the system administrator to set up individual devices that are freely available, 
assignable (owned by asg), or nonassignable and restricted (not owned by asg and with some restricted 
mode). 


Note also that the first time assign is invoked it builds the assignable devices table /etc/atab. This table 
is used in subsequent invocations to save repeated searches of the /dev directory. If one of the devices in 
/dev is changed to be assignable (i.e., owned by asg), then /etc/atab should be removed (by the super- 
user) so that a correct list will be built the next time the command is invoked. 
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Files 


Exit code 0 returned if successful, 1 if problems, 2 if device cannot be assigned. 
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Name 


at, atq, atrm — Executes commands at a later time. 


Syntax 


at time [| day | [ file | 


atq [ —1] 


atrm idnumber ... 


Description 


At causes the contents of a file to be executed as a shell script at a specified time. This command is 
useful for running processes at regular intervals, or when the system is not busy. The arguments are: 


time 1 to 4 digits, followed by an optional “‘a” for am, “p” for pm, “‘n” for noon, or “m” for mid- 
night. One- and two-digit numbers are interpreted as hours, three- and four-digit numbers as 
hours and minutes. If no letters follow the digits, 24-hour time is assumed. 


day Either a month name followed by a day number, or the name of a day of the week. If the word 
“week” follows the name of the day, the file is invoked seven days after the day named. Names 
of months and days may be recognizably truncated. (See the Examples later in this section.) 


file The name of the file containing the command(s) to be executed. If no file is specified, the stan- 
dard input is assumed. 


At creates a file that is executed by the shell at the specified time. This file contains a comment line that 
lists the user’s user ID and group ID, a cd command that changes the working directory of the process to 
the one you were using when you executed at, assignments to the appropriate environment variables, and 
the file specified in the at command line. Output from processes in file must be redirected or, (on most 
systems) it is lost. At shell scripts are run by periodic execution of the command /usr/lib/atrun from 
cron(C). 


The atqg command gives the following information about files waiting to be processed: 
— The user ID under which the file will run 
— A unique ID number used to reference the file 
— The date and time the file will be processed 
The -/ option displays the commands in each file in the queue. 
The atrm command removes files from the “at”? queue. Atrm uses the ID number(s) from the atq com- 
mand to remove the specific file(s). A user can only remove his own files. 
Examples 
Use the following line to place a file in the queue: 
at 8a jan 24 file 


In the following command line, file will be executed a week from this Friday at 3:30 pm. 
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at 1530 fr week file 
To remove a file from the queue, find out the ID number(s) with 
atq 
Then remove the file with atrm : 
atrm idnumber 
A sample at file might contain the line 
lpr biglongfile 


which sends biglongfile to the lineprinter. 


Files 


/usr/spool/at/yy.ddd.hhhh.uu 
Activity to be performed at hour Ahhh of day ddd of year yy. Uu is a unique 
number. 


/usr/spool/at/lasttimedone 
Contains hhhh for last hour of activity. 


/usr/spool/at/past Contains old at files. 
/usr/lib/atrun Program that executes activities at the specified time. 
See Also 


calendar(C), cron(C), pwd(C) 


Diagnostics 


Complains about various syntax errors and times out of range. 


Notes 
The directory /usr/spool/at/past should be periodically emptied by the super-user. 


Due to the granularity of the execution of /usr/lib/atrun, there may be problems in scheduling things ex- 
actly 24 hours into the future. 
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Name 


awk — Searches for and processes a pattern in a file. 


Syntax 


awk [-—Fc ] [ —f programfile |’program’ | [ file ... | 


Description 


Awk scans each input file for lines that match patterns specified in program or in programfile. When a 
line of file matches a pattern, an associated action may be performed. Awk is useful for compiling infor- 
mation, performing arithmetic on input data, and for doing iterative or conditional processing. 


The options are: 


=Fe Sets the field separator variable (FS) to the letter “‘c’. The default field separators are tab 
and space. 
—f Causes awk to take its program from programfile. 


The arguments are: 


programfile 
A file containing an awk program. 


program An awk program. Programs given on the command line must be enclosed in single quotation 
marks to prevent interpretation by the shell. 


file ... The name(s) of the file or files to be processed. If no filename is given, the standard output 1s 
used. 


An awk program consists of statements in the form: 
pattern { action } 
Pattern-action statements may appear on the awk command line, or in an awk program file. 


If no pattern is given, all lines in the input file are matched. If no action is given, each matched line is 
displayed on the standard output. 


A pattern may be a literal string or a regular expression, or a combination of a regular expression and a 
field or variable separated by operators. 


Awk also provides two patterns, BEGIN and END, that can be used to perform actions before the first 
line is read, and after the last line is read, respectively. 


To select a range of lines, use two patterns on a single program line, separated by a comma. 

An action is a sequence of statements separated by a semicolon, newline, or right brace. See Statements 
later in this section. 

Variables 


In addition to variables declared and initialized by the user, awk has the following program variables: 
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NR Number of records. 

NF Number of fields in a record. 
FS Input field separator. 

OFS Output field separator. 

RS Input record separator. 

ORS Output record separator. 

$0 The current record. 

$1, $n Fields in the current record. 


OFM The ouput format for numbers. The default is %.6g. 


FILENAME 
The name of the input file currently being read. 


Arrays may be used to store data. Arrays do not need to be dimensioned before use. For example, w[i] 
denotes the ith item of array w. 
Expressions 
A pattern match with a field or variable may be tested with the following operators: 
Matches the regular expression. 
!" Does not match the regular expression. 


Awk processes relational expressions using the following operators: 


< Less than 

<= Less than or equal to 
== Equal to 

l= Not equal to 

>= Greater than or equal to 
> Greater than 


Patterns can be combined using the operators: 
& & And 

| Or 

! Not 


An empty expression-list stands for the whole line. Expressions take on string or numeric values as ap- 
propriate, and are built using the following operators: 


5 Addition 
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Subtraction 

* Multiplication 
/ Division 

% Modulo 


Concatenation is indicated by a blank. 


The following C operators are also available in expressions: 


++ Increment 
—-— Decrement 
+= Add and assign 


Ze Subtract and assign 


+= Multiply and assign 
/= Divide and assign 
% = Modulo and assign 
Statements 


if ( conditional ) statement [ else statement | 

while ( conditional ) statement 

for ( expression ; conditional ; expression ) statement 
break 

continue 

{ [ statement ] ... } 

variable = expression 

print | expression-list | [ >expression | 

printf format [| , expression-list | [| >expression | 
next #skip remaining patterns on input line 


while Used the same as in C. 

for The iterative construction. It can be used the same as in the C language, or as an array 
iterator. 

break Similar to its C counterpart. 


continue Similar to its C counterpart. 

print Prints its arguments on the standard output, or in a file if redirected. 
printf Prints expression-list in the format specified in format. See printf(S). 
next Stops processing the current record and moves to the next record, if any. 


Comments are preceded by a number sign (#). 
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Functions 
Awk has the following built-in functions: 


exit(x) Terminates the awk program. If x is given, this value is awk’s return value. If x is not given, 0 
is returned. If the program has an END section, it is invoked before termination. 


exp(x) Exponentiation of the value of x. 
index(s, f) 
Returns the starting position of the leftmost occurrence of ¢ in s. If t is not a substring of s, 


then index(s, ¢) is 0. 


int(x) Returns the largest integer less than or equal to x. If x is negative, its value is the smallest in- 
teger greater than or equal to x. 


length(x) 
A function whose value is the number of characters in the string (x). With no arguments 


length is equivalent to $0. 


log(x) Natural logarithm of x. 


split(x, y) 
Assigns the fields of string x to successive elements of array y. 


sqrt(x) Square root of x. 
substr(string, index, length) 
Returns the substring of string that begins at index and is length characters long. 
Examples 

The following displays lines in file longer than 72 characters: 

awk “{length > 72}’ file 
The following prints the first two fields in opposite order: 

awk *{ print $2, $1 }’ file 
The following adds up the first columns and prints their sum and average: 


{s += $1 } 
END _ { print "sum is", s, 


average is", s/NR } 
The following prints the fields in fi/e in reverse order: 
awk { for (i = NF; i > 0; —-i) print $i } file 


The following awk program file will print all lines in the object file whose first field is different from the 
first field in the previous line: 


$1 != prev { print; prev = $1 } 
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See Also 
grep(C), lex(CP), sed(C) 
The XENIX Text Processing Guide 
Notes 
Input whitespace is not preserved on output if fields are involved. 


There are no explicit conversions between numbers and strings. To force an expression to be treated as 
a number add 0 to it; to force it to be treated as a string concatenate the null string ("") to it. 


This command is more fully documented in the XENIX Text Processing Guide. 
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Name 


backup — Performs incremental file system backup. 


Syntax 


backup [ key [ arguments ] filesystem ] 


Description 


Backup copies to the specified device all files changed after a certain date in the filesystem. The key 
specifies the date and other options about the backup, where a key consists of characters from the set 
0123456789kfusd. The meanings of these characters are described below: 


f Places the backup on the next argument file instead of the default device. 


u If the backup completes successfully, writes the date of the beginning of the backup to the file 
/etc/ddate. This file records a separate date for each file system and each backup level. 


0-9 This number is the “backup level’. Backs up all files modified since the last date stored in the file 
/etc/ddate for the same file system at lesser levels. If no date is determined by the level, the be- 
ginning of time is assumed; thus the option 0 causes the entire file system to be backed up. 


S For backups to magnetic tape, the size of the tape specified in feet. The number of feet is taken 
from the next argument. When the specified size is reached, backup will wait for reels to be 
changed. The default size is 2,300 feet. 


d For backups to magnetic tape, the density of the tape, expressed in BPI, is taken from the next ar- 
gument. This is used in calculating the amount of tape used per write. The default is 1600. 


k This option is used when backing up to a block-structured device, such as a floppy disk. The size 
(in K-bytes) of the volume being written is taken from the next argument. If the k argument is 
specified, any s and d arguments are ignored. The default is to use s and d. 


If no arguments are given, the key is assumed to be 9u and a default file system is backed up to the de- 
fault device. 


The first backup should be a full level-O backup: 
backup Ou 

Next, periodic level 9 backups should be made on an exponential progression of tapes or floppies: 
backup 9u 


(This is sometimes called the Tower of Hanoi progression after the name of the game where a similar 
progression occurs, i.e., 1 2 1 3 1 2 1 4... where backup 1 is used every other time, backup 2 every 
fourth, backup 3 every eighth, etc.) When the level-9 incremental backup becomes unmanageable 
because a tape is full or too many floppies are required, a level-1 backup should be made: 


backup lu 


After this, the exponential series should progress as if uninterrupted. These level-9 backups are based 
on the level-1 backup, which is based on the level-0 full backup. This progression of levels of backups 
can be carried as far as desired. 
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The default file system and the backup device depend on the settings of the variables DISK and TAPE, 
respectively, in the file /etc/default/backup. 

Files 
/etc/ddate Records backup dates of file system/level 


etc/default/backup Default backup information 


See Also 
XENIX Operations Guide 
cpio(C), default(M), dumpdir(C), restore(C), backup(F) 
Diagnostics 
If the backup requires more than one volume (where a volume is likely to be a floppy disk or tape), you 
will be asked to change volumes. Press RETURN after changing volumes. 
Notes 


Sizes are based on 1600 BPI for blocked tape; the raw magnetic tape device has to be used to approach 
these densities. Write errors to the backup device are usually fatal. Read errors on the file system are 
ignored. 


Warning 


When backing up to floppy disks, be sure to have enough formatted floppies ready before starting a 
backup. 
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Name 


banner — Prints large letters. 


Syntax 


banner strings 


Description 


Banner prints its arguments (each up to 10 characters long) in large letters on the standard output. 
This is useful for printing names at the front of printouts. 
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Name 


basename — Removes directory names from pathnames. 


Syntax 


basename string [ suffix ] 


Description 


Basename deletes any prefix ending in / and the suffix (if present in string) from string, and prints the 
result on the standard output. The result is the “base” name of the file, i.e., the filename without any 
preceding directory path and without an extension. It is used inside substitution marks (**) in shell pro- 
cedures to construct new filenames. 


The related command dirname deletes the last level from string and prints the resulting path on the 
standard output. 
Examples 
The following command displays the filename memos on the standard output: 
basename /usr/johnh/memos.old .old 


The following shell procedure, when invoked with the argument /usr/src/cmd/cat.c, compiles the named 
file and moves the output to a file named cat in the current directory: 


cc $1 
mv a.out ‘*basename $1 .c* 


See Also 


dirname(C), sh(C) 
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Name 


be — Invokes a calculator. 


Syntax 


be [ett =f] Piles 


Description 


Bc is an interactive processor for a language that resembles C but provides unlimited precision arith- 
metic. It takes input from any files given, then reads the standard input. The —l argument stands for 
the name of an arbitrary precision math library. The syntax for bc programs is as follows: L means the 
letters a—z, E means expression, S means statement. 


Comments: 
Enclosed in /* and */ 
Names: 


Simple variables: L 
Array elements: L [ E | 


99 866 


The words “‘ibase’’, “‘obase’’, and “‘scale”’ 
Other operands: 


Arbitrarily long numbers with optional sign and decimal point 


CE) 

sqrt (E ) 

length ( E ) Number of significant decimal digits 
scale ( E ) Number of digits right of decimal point 
7a @ pers 


Additive operators: 


a 


Multiplicative operators: 


* 


% (remainder) 
* (exponentiation) 
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Unary operators: 


++ 
—-— (prefix and postfix; apply to names) 


Relational operators: 


i eras 
l il 


— 


VA 


Assignment operators: 


(Stat St 

de oe 

while (E)S 

ior f Pe hse ys 
null statement 
break 

quit 


Function definitions: 


dene Ltt wb V4 
AUtO Loy Ls 
Seca 
return ( E ) 
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Functions in —] math library: 


S(x) Sine 

C(x) Cosine 

e(x) Exponential 
I(x) Log 

a(x)  Arctangent 
j(n,x) Bessel function 


All function arguments are passed by value. 


The value of a statement that is an expression is printed unless the main operator is an assignment. 
Either semicolons or newlines may separate statements. Assignment to scale influences the number of 
digits to be retained on arithmetic operations in the manner of dc(C). Assignments to ibase or obase 
set the input and output number radix respectively. 


The same letter may be used as an array, a function, and a simple variable simultaneously. All vari- 
ables are global to the program. “Auto” variables are pushed down during function calls. When using 
arrays as function arguments or defining them as automatic variables, empty square brackets must 
follow the array name. 


Bc is actually a preprocessor for dc(C), which it invokes automatically, unless the —c (compile only) op- 
tion is present. If the —c option is present, the dc input is sent to the standard output instead. 


Example 
The following defines a function to compute an approximate value of the exponential function: 
scale = 20 


define e(x){ 
ato. a, OC. 4s 


a= 1 
b= 1 
s= |] 
for(i=1; 1==1; i++){ 
a = atx 
b = bei 
c=a/b 
if(c == 0) return(s) 
S = stc 
} 


} 


The following prints the approximate values of the exponential function of the first ten integers: 
fordi=1; i<=10; i++) e(i) 
Files 
/usr/lib/lib.bc Mathematical library 


/usr/bin/de Desk calculator proper 


June 28, 1985 Page 3 


BC (C) Be (©) 


See Also 
dc(C) 
The XENIX User’s Guide 
Notes 
A For statement must have all three E’s. 


Quit is interpreted when read, not when executed. 


June 28, 1985 Page 4 


‘m 


BDIFF (C) BDIFF (C) 


Name 


bdiff — Compares files too large for diff. 


Syntax 


bdiff file! file2 [ n] [-s] 


Description 


Bdiff finds compares two files, finds lines that are different, and prints them on the standard output. It 
allows processing of files that are too large for diff. Bdiff splits each file into n-line segments, begin- 
ning with the first nonmatching lines, and invokes diff upon the corresponding segments. The argu- 
ments are: 


n The number of lines bdiff splits each file into for processing. The default value is 3500. This is 
useful when 3500-line segments are too large for diff. 


—s Suppresses printing of bdiff diagnostics. Note that this does not suppress printing of diagnostics 
from diff. 


If filel (orfile2) is a dash (—), the standard input is read. 


The output of bdiff is exactly that of diff. Line numbers are adjusted to account for the segmenting of 
the files, and the output looks as if the files had been processed whole. 


Files 


See Also 


diff(C) 


Notes 


Because of the segmenting of the files, bdiff does not necessarily find a smallest sufficient set of file 
differences. 
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Name 


bfs — Scans big files. 


Syntax 


bfs [ — ] name 


Description 


Bfs is like ed(C) except that it is read-only and processes much larger files. Files can be up to 1024K 
bytes and 32K lines, with up to 255 characters per line. Bfs is usually more efficient than ed for scan- 
ning a file, since the file is not copied to a buffer. It is most useful for identifying sections of a large file 
where csplit (C) can be used to divide it into more manageable pieces for editing. 


Normally, the size of the file being scanned is printed, as is the size of any file written with the w com- 
mand. The optional dash (—) suppresses printing of sizes. Input is prompted for with an asterisk (*) by 
default. If a “P” and a RETURN are typed as in ed, then prompting is turned off. The “P” acts as a 
toggle, so prompting can be turned on again by entering another “P” and a RETURN. Note that mes- 
sages are given in response to errors only if prompting is turned on. 


All address expressions described under ed are supported. In addition, regular expressions may be sur- 
rounded with two symbols other than the standard slash (/) and (?): A greater-than sign (>) indicates 
downward search without wraparound, and a less-than sign (<) indicates upward search without wra- 
paround. Since bfs uses a different regular expression-matching routine from ed, the regular expressions 
accepted are slightly wider in scope (see regex (S)). The differences from ed syntax include the fact 
that parentheses and curly braces are special and need not be escaped. Differences are listed below: 


+: A regular expression followed by + means one or more times. For example, [0—9]+ is 
equivalent to [0—9][0—9]«. 


{m} {m,} {m,u} 
Integer values enclosed in {} indicate the number of times the preceding regular expression is to 
be applied. m is the minimum number and uw is a number, less than 256, which is the max- 
imum. If only m is present (e.g., {m}), it indicates the exact number of times the regular ex- 
pression is to be applied. {m,} is analogous to {m,infinity}. The plus (+) and star (*) operations 
are equivalent to {1,} and {0,} respectively. 


(... )$” The value of the enclosed regular expression is to be returned. The value will be stored in the 
(n+1)th argument following the subject argument. At most ten enclosed regular expressions are 
allowed. Regex makes its assignments unconditionally. 


(...) Parentheses are used for grouping. An operator, e.g. *, +, {}, can work on a single character or 
a regular expression enclosed in parenthesis. For example, (a*(cb+)*)$0. 


There is also a slight difference in mark names: only the letters “a” through “z’’ may be used, and all 26 
marks are remembered. 


The e, g, v, k, n, p, q, w, =, ! and null commands operate as described under ed. Commands such as ---, 
+++—, +++=, —12, and +4p are accepted. Note that 1,10p and 1,10 will both print the first ten lines. 
The f command only prints the name of the file being scanned; there is no remembered filename. The w 
command is independent of output diversion, truncation, or crunching (see the xo, xt and xc commands, 
below). The following additional commands are available: 


xf file 
Further commands are taken from the named file. When an end-of-file is reached, an interrupt 
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signal is received, or an error occurs, reading resumes with the file containing the xf. Xf com- 
mands may be nested to a depth of 10. 


xo | file | 


Further output from the p and null commands is diverted to the named file. If file is missing, 
output is diverted to the standard output. Note that each diversion causes truncation or creation 
of the file. 


: label 
This positions a /abel in a command file. The /abel is terminated by a newline, and blanks 
between the : and the start of the /abel are ignored. This command may also be used to insert 
comments into a command file, since labels need not be referenced. 


(.,.)xb/regular expression/label 
A jump (either upward or downward) is made to Jabel if the command succeeds. It fails under 
any of the following conditions: 


1. Either address is not between 1 and §. 
2. The second address is less than the first. 


3. The regular expression doesn’t match at least one line 
in the specified range, including the first and last lines. 


On success, dot (.) is set to the line matched and a jump is made to Jabel. This command is the 
only one that doesn’t issue an error message on bad addresses, so it may be used to test whether 
addresses are bad before other commands are executed. Note that the command 


xb/*/ label 
is an unconditional jump. 


The xb command is allowed only if it is read from somewhere other than a terminal. If it is read 
from a pipe only a downward jump is possible. 


xt number 
Output from the p and null commands is truncated to a maximum of number characters. The ini- 
tial number is 255. 


xv| digit | [spaces | [value] 
The variable name is the specified digit following the xv. Xv5100 or xv5 100 both assign the value 
100 to the variable 5. Xv61,100p assigns the value 1,100p to the variable 6. To reference a vari- 


able, put a % in front of the variable name. For example, using the above assignments for vari- 
ables 5 and 6: 


1,%5p 
1,%5 
%o6 
prints the first 100 lines. 
g/%5/p 


globally searches for the characters 100 and prints each line containing a match. To escape the 
special meaning of %, a \ must precede it. For example, 


g/".*\Zo[cds]/p 
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could be used to match and list lines containing printf characters, decimal integers, or strings. 


Another feature of the xv command is that the first line of output from a XENIX command can be 
stored into a variable. The only requirement is that the first character of value be a !. For ex- 
ample, 


xv5!cat junk 
'rm junk 

'echo "%5" 
xv6lexpr %6 + 1 


puts the current line in variable 5, prints it, and increments the variable 6 by one. To escape the 
special meaning of ! as the first character of value, precede it with a \. For example, 


xv7\!date 
stores the value !date into variable 7. 


xbz /abel 


xbn Jabel 
These two commands test the last saved return code from the execution of a XENIX command 
(!command) or nonzero value, respectively, and jump to the specified label. The two examples 
below search for the next five lines containing the string size: 


xv55 
eA] 
/size/ 
xvS!expr %5 — 1 
lif 0O%5 '!= 0 exit 2 
xbn | 


xv45 
mM 
/size/ 
xv4lexpr %4 — 1 
lif 0%4 = 0 exit 2 
xbz | 


xe [switch | 
If switch is 1, output from the p and null commands is crunched; if switch is 0 it isn’t. Without 


an argument, xe reverses switch. Initially, switch is set for no crunching. Crunched output has 
strings of tabs and blanks reduced to one blank and blank lines suppressed. 


See Also 


csplit(C), ed(C), regex(S) 
Diagnostics 


If prompting is turned off, a question mark is printed (?) for errors in commands. When prompting is 
on, self-explanatory error messages appear. 


June 28, 1985 | Page 3 


CAL (C) CAL (C) 


Name 


cal — Prints a calendar. 


Syntax 


cal [[ month ] year] 


Description 


Cal prints a calendar for the specified year. If a month is also specified, a calendar for that month only 
is printed. If no arguments are specified, the current, previous, and following months are printed, along 
with the current date and time. The year must be a number between 1 and 9999; month must be a 
number between 1 and 12 or enough characters to specify a particular month. For example, May must 
be given to distinguish it from March, but S is sufficient to specify September. If only a month string is 
given, only that month of the current year is printed. 


Notes 
Beware that “cal 84” refers to the year 84, not 1984. 


The calendar produced is that for England and her colonies. Note that England switched from the Ju- 
lian to the Gregorian calendar in September of 1752, at which time eleven days were excised from the 
year. To see the result of this switch, try “cal 9 1752”. 
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Name 
a 


calendar — Invokes a reminder service. 


Syntax 


calendar [ — | 


Description 


Calendar consults the file calendar in the user’s current directory and mails him lines that contain 
today’s or tomorrow’s date. Most reasonable month-day dates, such as “Dec. 7,” and “december 7” are 
recognized, but not “7 December”, “7/12” or “07/12”. 


On weekends “tomorrow” extends through Monday. Lines that contain the date of a Monday will be 
sent to the user on the previous Friday. This is not true for holidays. 


When an argument is present, calendar does its job for every user who has a file calendar in his login 
directory and sends the user the results by mail(C). Normally this is done daily, in the early morning, 
under the control of cron(C). 
Files 
calendar 
/usr/lib/calprog To figure out today’s and tomorrow’s dates 
/etc/passwd 
/tmp/cal* 
/usr/lib/crontab 


See Also 


cron(C), mail(C) 


Notes 


To get reminder service, a user’s calendar file must have read permission for all. 
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Name 


cat — Concatenates and displays files. 


Syntax 


cat [| —w) [8] file... 


Description 


Cat reads each file in sequence and writes it on the standard output. If no input file is given, or if a 
single dash (—) is given, cat reads from the standard input. The options are: 


—s Suppresses warnings about nonexistent files. 
—u Causes the output to be unbuffered. 


No input file may have the same name as the output file unless it is a special file. 


Examples 


The following example displays file on the standard output: 


cat file 


The following example concatenates filel and file2 and places the result in file3: 
cat filel file2 >file3 
The following example concatenates filel and appends it to file2: 


cat filel >> file2 


See Also 


cp(C), pr(C) 


June 28, 1985 Page 1 


- 


Cte) CD (C) 


Name 


cd — Changes working directory. 


Syntax 


cd [ directory | 


Description 


If specified, directory becomes the new working directory; otherwise the value of the shell parameter 
$HOME is used. The process must have search (execute) permission in all directories (components) 
specified in the full pathname of directory. 


Because a new process is created to execute each command, cd would be ineffective if it were written as 
a normal command; therefore, it is recognized and executed by the shell. 


If the shell is reading its commands from a terminal, and the specified directory does not exist (or some 
component cannot be searched), spelling correction is applied to each component of directory, in a 
search for the “correct” name. The shell then asks whether or not to try and change directory to the 
corrected directory name; an answer of n means “no”, and anything else is taken as “yes”. 


Notes 


Wildcard designators do not work with the ed command. 


See Also 


pwd(C), sh(C), chdir(S) 
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Name 


chgrp — Changes group ID. 


Syntax 


cherp group file ... 


Description 


Chgrp changes the group ID of each file to group. The group may be either a decimal group ID or a 
group name found in the file /etc/group. 


Files 


/etc/passwd 


/etc/group 


See Also 


chown(C), chown(S), passwd(M), group(M) 


Notes 


Only the owner or the super-user can change the group ID of a file. 
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Name 


chmod — Changes the access permissions of a file or directory. 


Syntax 
chmod mode file ... 
chmod [who] +—= [permission ...] file ... 
Description 


The chmod command changes the access permissions (or mode) of a specified file or directory. It is used 
to control file and directory access by users other than the owner and super-user. The mode may be an 
expression composed of letters and operators (called symbolic mode), or a number (called absolute 
mode). 


A chmod command using symbolic mode has the form: 
chmod [who] +—= [permission ...] filename 
Who is one or any combination of the following letters: 


a Stands for “‘all users’. If who is not indicated on the command line, a is the default. The definition 
of “all users” depends on the user’s umask. See umask (C). 


g Stands for “group”, all users who have the same group ID as the owner of the file or directory. 
o Stands for “others’’, all users on the system. 

u Stands for “‘user’’, the owner of the file or directory. 

The operators are: 

+ Adds permission 

— Removes permission 


= Assigns the indicated permission and removes all other permissions (if any) for that who. If no per- 
mission is assigned, existing permissions are removed. 


Permissions can be any combination of the following letters: 
x Execute (search permission for directories) 

r Read 

w Write 


s Sets owner or group ID on execution of the file to that of the owner of the file. The mode “u+s” 
sets the user ID bit for the file. The mode “g+s” sets the group ID bit. Other combinations have 
no effect. 


t Saves text in memory upon execution. (“Sticky bit”, see chmod(S)). Only the mode “u+t” sets the 
sticky bit. All other combinations have no effect. This mode can only be set by the super-user. 


Multiple symbolic modes may be given, separated by commas, on a single command line. See the fol- 
lowing Examples section for sample permission settings. 
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A chmod command using absolute mode has the form: 
chmod mode filename 


where mode is an octal number constructed by performing logical OR on the following: 


4000 Set user ID on execution 
2000 Set group ID on execution 
1000 Sets the sticky bit (see chmod(S)) 
0400 Read by owner 
0200 Write by owner 
0100 Execute (search in directory) by owner 
0040 Read by group 
0020 Write by group 
0010 Execute (search in directory) by group 
0004 Read by others 
0002 Write by others 
0001 Execute (search in directory) by others 
0000 No permissions 

Examples 


Symbolic Mode 

The following command gives all users execute permission for file: 
chmod +x file 

The following command removes read and write permission for group and others from file: 
chmod go-rw file 

The following command gives other users read and write permission for file: 
chmod o+rw file 

The following commmand gives read permission to group and other: 


chmod g+r,o+tr file 


Absolute Mode 
The following command gives all users read, write and execute permission for fie: 


chmod 0777 file 
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The following command gives read and write permission to all users for file: 
chmod 0666 file 
The following command gives read and write permission to the owner of file only: 


chmod 0600 file 


See Also 


Is(C), chmod(S) 


Notes 


The user ID, group ID and sticky bit settings are only useful for binary executable files. They have no 
effect on shell scripts. 
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Name 


chown — Changes owner ID. 


Syntax 


chown owner file ... 


Description 


Chown changes the owner ID of the files to owner. The owner may be either a decimal user ID or a 
login name found in the file /etc/passwd. 


Files 


/etc/passwd 


/etc/group 


See Also 


chgrp(C), chown(S), group(M), passwd(M) 


Notes 


Only the owner or the super-user can change a file’s owner or group ID. 
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Name 


chroot — Changes root directory for command. 


Syntax 


chroot newroot command 


Description 


The given command is executed relative to the new root. The meaning of any initial slashes (/) in path- 
names is changed for a command and any of its children to newroot. Furthermore, the initial working 
directory is newroot. 


Notice that: 

chroot newroot command >x 
creates the file x relative to the original root, not the new one. 
This command is restricted to the super-user. 


The new root pathname is always relative to the current root even if a chroot is currently in effect. The 
newroot argument is relative to the current root of the running process. Note that it is not possible to 
change directories to what was formerly the parent of the new root directory; i.e., the chroot command 
supports the new root as an absolute root for the duration of the command. This means that “/..” is al- 
ways equivalent to “/”’. 


See Also 


chdir(S) 


Notes 


Exercise extreme caution when referencing special files in the new root file system. 
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Name 


cmp — Compares two files. 


Syntax 


cmp [ —1 | [ —s | filel file2 


Description 


Cmp compares two files and, if they are different, displays the byte and line number of the differences. 
If filel is —, the standard input is used. 


The options are: 
—] Prints the byte number (decimal) and the differing bytes (octal) for each difference. 


—S Returns an exit code only, 0 for identical files, 1 for different files and 2 for an inaccessible or 
missing file. 


This command should be used to compare binary files; use diff(C) or diff3 (C) to compare text files. 


See Also 
comm(C), diff(C), diff3(C) 


Diagnostics 


Exit code 0 is returned for identical files, 1 for different files, and 2 for an inaccessible or missing argu- 
ment. 
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Name 


comm — Selects or rejects lines common to two sorted files. 


Syntax 
comm [ — [ 123 ] ] filel file2 


Description 


Comm reads filel and file2, which should be ordered in ASCII collating sequence (see sort(C)), and 
produces a three-column output: lines only in fileJ; lines only in file2; and lines in both files. The 
filename — means the standard input. 


Flags 1, 2, or 3 suppress printing of the corresponding column. Thus comm —12 prints only the lines 
common to the two files; comm —23 prints only lines in the first file but not in the second; comm —123 


is a no-op. 
See Also 


cmp(C), diff(C), sort(C), uniq(C) 
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Name 


copy — Copies groups of files. 


Syntax 


copy [ option ] ... source ... dest 


Description 


The copy command copies the contents of directories to another directory. It is possible to copy whole 
file systems since directories are made when needed. 


If files, directories, or special files do not exist at the destination, then they are created with the same 
modes and flags as the source. In addition, the super—user may set the user and group ID. The owner 
and mode are not changed if the destination file exists. Note that there may be more than one source 
directory. If so, the effect is the same as if the copy command had been issued for each source directory 
with the the same destination directory for each copy. 


Under XENIX 3.0, options do not have to be given as separate arguments, and may appear in any order, 
even after the other arguments. The arguments are: 


=e Asks the user before attempting a copy. If the response does not begin with a “y’’, then a copy 
is not done. This option also sets the —ad option. 


i=l Uses links instead whenever they can be used. Otherwise a copy is done. Note that links are 
never done for special files or directories. 


—n Requires the destination file to be new. If not, then the copy command does not change the 
destination file. The —n flag is meaningless for directories. For special files an —n flag is as- 
sumed (i.e., the destination of a special file must not exist). 


—0O If set then every file copied has its owner and group set to those of the source. If not set, then 
the file’s owner is the user who invoked the program. 


—m If set, then every file copied has its modification time and access time set to that of the source. 
If not set, then the modification time is set to the time of the copy. 


ss If set, then every directory is recursively examined as it is encountered. If not set then any 
directories that are found are ignored. 


—ad Asks the user whether an —r flag applies when a directory is discovered. If the answer does not 
begin with a “‘y’, then the directory is ignored. 


—V If the verbose option is set messages are printed that reveal what the program is doing. 


source This may be a file, directory or special file. It must exist. If it is not a directory, then the 
results of the command are the same as for the cp command. 


dest The destination must be either a file or directory that is different from the source. 


If the source and destination are anything but directories, then copy acts just like a cp command. If 
both are directories, then copy copies each file into the destination directory according to the flags that 
have been set. 
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Notes | 
Special device files can be copied. When they are copied any data associated with the specified device is Oo 
not copied. 
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Name 


cp — Copies files. 


Syntax 
cp filel file2 


cp files directory 


Description 


There are two ways to use the cp command. With the first way, file] is copied to file2. Under no cir- 
cumstance can filel and file2 be identical. With the second way, directory is the location of a directory 
into which one or more files are copied. 


See Also 


copy(C), cpio(C), In(C), mv(C), rm(C), chmod(S) 


Notes 


Special device files can be copied. If the file is a named pipe, then the data in the pipe is copied to a re- 
gular file. Similarly, if the file is a device, then the file is read until the end-of-file is reached, and that 
data is copied to a regular file. It is illegal to copy a directory to a file. 
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Name 


cpio — Copies file archives in and out. 


Syntax 
cpio —o [ acBy | 
cpio —i [ Bcedmrtuy | [ patterns ] 


cpio —p [ adlmruy | directory 


Description 


Cpio —o (copy out) reads the standard input to obtain a list of pathnames and copies those files onto the 
standard output together with pathname and status information. 


Cpio —i (copy in) extracts from the standard input (which is assumed to be the product of a previous 
cpio —o) the names of files selected by zero or more patterns given in the name-generating notation of 
sh(C). In patterns, the special characters ?, *, and [...] match the slash ( / ) character. The default 
for patterns is * (i.e., select all files). 


Remember to escape special characters to prevent expansion by the shell. 


Cpio —p (pass) copies out and in during a single operation. Destination pathnames are interpreted rela- 
tive to the named directory. 


The meanings of the available options are: 
—a Resets access times of input files after they have been copied. 


—B Blocks input/output 5,120 bytes to the record (does not apply to the pass option; meaningful 
only with data directed to or from raw devices). 


—d Directories are created as needed. 

seo Writes header information in ASCII character form for portability. 

—r Interactively renames files. If the user types a null line, the file is skipped. 

={ Prints a table of contents of the input. No files are created. 

—u Copies unconditionally (normally an older file will not replace a newer file with the same name). 
—=y Verbose: causes a list of filenames to be printed. When used with the —t option, the table of 


contents looks like the output of an Is —] command (see /s(C)). 


=i Whenever possible, links files rather than copying them. Usable only with the —p option. 
—m Retains previous file modification time. This option is ineffective on directories that are being 
copied. 
Examples 


The first example below copies the contents of a directory into an archive; the second duplicates a direc- 
tory hierarchy: 
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Is | cpio —o >/dev/fd 


cd olddir 
find . —print | cpio —pdl newdir 


Or: 


find . —print | cpio —oB >/dev/rfd 


See Also 


ar(CP), find(C), cpio(F) 


Notes 


Pathnames are restricted to 128 characters. If there are too many unique linked files, the program runs 
out of memory to keep track of them and thereafter linking information is lost. Only the super-user can 
copy special files. 
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Name 


cron — Executes commands at specified times. 


Syntax 


/etc/cron 


Description 


Cron 1s the clock daemon that executes commands at specified dates and times according to the instruc- 
tions in the file /usr/lib/crontab. Because cron never exits, it should be executed only once. This is 
best done by running cron from the initialization process through the file /etc/re. 


The file crontab consists of lines of six fields each. The fields are separated by spaces or tabs. The first 
five are integer patterns that specify the minute (0-59), hour (0-23), day of the month (1-31), month of 
the year (1-12), and day of the week (0-6, with O=Sunday). Each of these patterns may contain: 


— A number in the (respective) range indicated above 

— Two numbers separated by a minus (indicating an inclusive range) 

— A list of numbers separated by commas (meaning all of these numbers) 
— An asterisk (meaning all legal values) 


The sixth field is a string that is executed by the shell at the specified time(s). A % in this field is 
translated into a newline character. Only the first line (up to a % or end-of-line) of the command field 
is executed by the shell. The other lines are made available to the command as standard input. 


Cron examines crontab periodically to see if it has changed; if it has, cron reads it. Thus it takes only a 
short while for entries to become effective. 
Examples 


An example crontab file follows: 


30:4 =>" /etc/sa -s > /dev/null 

RE Midiesd calendar - 

| Go alias find /usr/preserve -mtime +7 -a -exec rm -f {} ; 
304111 /usr/lib/uucp/cleanlog 

40 4 * ** find / -name ’#*’ -atime +3 -exec rm -f {} ; 


0,5,10,15,20,25,30,35,40,45,50,55 * * * * /usr/lib/atrun 
0,10,20,30,40,50 * * * * /etc/dmesg - > > /usr/adm/messages 
1,21,41 * * * * (echo -n’ ’; date; echo ) > /dev/console 


A history of all actions by cron can be recorded in /usr/lib/cronlog. This logging occurs only if the 
variable CRONLOG in /etc/default/cron is set to YES. By default this value is set to NO and no log- 
ging occurs. If logging should be turned on, be sure to monitor the size of /usr/lib/crontab so that it 
doesn’t unreasonably consume disk space. 
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Files 
/usr/lib/crontab 
/usr/lib/cronlog 


/etc/default/cron 


See Also 


sh(C) 


Notes 


CRON (C) 


Cron reads crontab only when it has changed, but it reads the in-core version of that table periodically. 
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Name 


crypt — Encodes and decodes files. 


Syntax 


crypt [| password | 


Description 


Crypt reads from the standard input and writes on the standard output. The password is a key that 
selects a particular transformation. If no password is given, crypt demands a key from the terminal and 
turns off printing while the key is being typed in. Crypt encrypts and decrypts with the same key. 


Files encrypted by crypt are compatible with those created by the editor ed (C) in encryption mode. 


The security of encrypted files depends on three factors: the fundamental method of encryption must be 
hard to solve; direct search of the key space must be infeasible; “sneak paths’ by which keys or clear 
text can become visible must be minimized. 


The transformation of a key into the internal settings of the machine is deliberately designed to be ex- 
pensive, i.e. to take a substantial fraction of a second to compute. However, if keys are restricted to 
(say) three lowercase letters, then encrypted files can be read by expending less than five minutes of 
machine time. 


Since the key is an argument to the crypt command, it is potentially visible to users executing ps(C) or 
a derivative. To minimize this possibility, crypt destroys any record of the key immediately upon entry. 
The choice of keys and key security are the most vulnerable aspect of crypt. 

Example 
The following will print the contents of the file clear: 


crypt key <clear >cypher 


crypt key <cypher | pr 


See Also 


ed(C), makekey(M) 


Notes 


If output is piped to nroff(CT) and the encryption key is not given on the command line, crypt can 
leave terminal modes in a strange state (see stty (C)). 


Crypt implements a one-rotor machine designed along the lines of the German Enigma, but with a 256- 
element rotor. Methods of attack on such machines are known, but not widely; moreover the amount of 
work required is likely to be large. 
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Name 


csh — Invokes a shell command interpreter with C-like syntax. 


Syntax 


csh [ —cefinstvVxX | [ arg... ] 


Description 


Csh is a command language interpreter. It begins by executing commands from the file .cshre in the 
home directory of the invoker. If this is a login shell, then it also executes commands from the file 
login there. In the normal case, the shell will then begin reading commands from the terminal, promp- 
ting with % . Processing of arguments and the use of the shell to process files containing command 
scripts will be described later. 


The shell then repeatedly performs the following actions: a line of command input is read and broken 
into words. This sequence of words is placed on the command history list and then parsed. Finally each 
command in the current line is executed. 


When a login shell terminates, it executes commands from the file .logout in the user’s home directory. 
Lexical structure 


The shell splits input lines into words at blanks and tabs with the following exceptions. The characters 
&, 43, <, >, (, ), form separate words. If doubled in &&, || <<, or >>, these pairs form single 
words. These parser metacharacters may be made part of other words, or prevented their special mea- 
ning, by preceding them with \. A newline preceded by a \ is equivalent to a blank. 


In addition strings enclosed in matched pairs of quotations, ’, ‘ or ", form parts of a word; metacharac- 
ters in these strings, including blanks and tabs, do not form separate words. These quotations have se- 
mantics to be described subsequently. Within pairs of or " characters a newline preceded by a \ gives a 
true newline character. 


When the shell’s input is not a terminal, the character # introduces a comment which continues to the 
end of the input line. It does not have this special meaning when preceded by \ and placed inside the 
quotation marks °, ’, and ". 


Commands 


A simple command is a sequence of words, the first of which specifies the command to be executed. A 
simple command or a sequence of simple commands separated by | characters forms a pipeline. The 
output of each command in a pipeline is connected to the input of the next. Sequences of pipelines may 
be separated by ;, and are then executed sequentially. A sequence of pipelines may be executed without 
waiting for it to terminate by following it with an &. Such a sequence is automatically prevented from 
being terminated by a hangup signal; the nohup command need not be used. 


Any of the above may be placed in parentheses to form a simple command (which may be a component 
of a pipeline, etc.) It is also possible to separate pipelines with ||or && indicating, as in the C language, 
that the second is to be executed only if the first fails or succeeds respectively. (See Expressions.) 


Substitutions 


The following sections describe the various transformations the shell performs on the input in the order 
in which they occur. 
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History Substitutions 


History substitutions can be used to reintroduce sequences of words from previous commands, possibly 
performing modifications on these words. Thus history substitutions provide a generalization of a redo 
function. 


History substitutions begin with the character ! and may begin anywhere in the input stream if a history 
substitution is not already in progress. This ! may be preceded by a \ to prevent its special meaning; a ! 
is passed unchanged when it is followed by a blank, tab, newline, =, or (. History substitutions also 
occur when an input line begins with ~. This special abbreviation will be described later. 


Any input line which contains history substitution is echoed on the terminal before it is executed as it 
could have been typed without history substitution. 


Commands input from the terminal which consist of one or more words are saved on the history list, the 
size of which is controlled by the history variable. The previous command is always retained. Com- 
mands are numbered sequentially from 1. 


For example, consider the following output from the history command: 


9 write michael 
10 ex write.c 

11 cat oldwrite.c 
12 diff *write.c 


The commands are shown with their event numbers. It is not usually necessary to use event numbers, 
but the current event number can be made part of the prompt by placing a ! in the prompt string. 


With the current event 13 we can refer to previous events by event number !11, relatively as in !—2 
(referring to the same event), by a prefix of a command word as in !d for event 12 or !w for event 9, or 
by a string contained in a word in the command as in !?mic? also referring to event 9. These forms, 
without further modification, simply reintroduce the words of the specified events, each separated by a 
single blank. As a special case !! refers to the previous command; thus !! alone is essentially a redo. The 
form !# references the current command (the one being typed in). It allows a word to be selected from 
further left in the line, to avoid retyping a long name, as in !#:1. 


To select words from an event we can follow the event specification by a : and a designator for the 
desired words. The words of a input line are numbered from 0, the first (usually command) word being 
0, the second word (first argument) being 1, and so on. The basic word designators are: 


0 First (command) word 


n 
nth argument 


First argument, i.e. 1 
$ Last argument 


% Word matched by (immediately preceding) ?s5? search 


x—y 
Range of words 


—y Abbreviates 0—y 


* Abbreviates “—$, or nothing if only 1 word in event 
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x* Abbreviates x—$ 
x— Like ‘x* but omitting word $ 


The : separating the event specification from the word designator can be omitted if the argument selector 
begins with a f, $, * — or %. After the optional word designator can be placed a sequence of modifiers, 
each preceded by a:. The following modifiers are defined: 


h Removes a trailing pathname component 


r Removes a trailing .xxx component 


s/I/r/ 


Substitutes / for r 
t Removes all leading pathname components 
& Repeats the previous substitution 
g Applies the change globally, prefixing the above 
p Prints the new command but do not execute it 
q Quotes the substituted words, preventing substitutions 
x Like q, but breaks into words at blanks, tabs, and newlines 


Unless preceded by a g the modification is applied only to the first modifiable word. In any case it is an 
error for no word to be applicable. 


The left side of substitutions are not regular expressions in the sense of the editors, but rather strings. 
Any character may be used as the delimiter in place of /; a \ quotes the delimiter into the / and r 
strings. The character & in the right side is replaced by the text from the left. A \ quotes & also. A 
null / uses the previous string either from a / or from a contextual scan string s in !?s?. The trailing 
delimiter in the substitution may be omitted if a newline follows immediately as may the trailing ? ina 
contextual scan. 


A history reference may be given without an event specification, e.g. !$. In this case the reference is to 
the previous command unless a previous history reference occurred on the same line in which case this 
form repeats the previous reference. Thus !?foo?"!$ gives the first and last arguments from the com- 
mand matching ?foo?. 


A special abbreviation of a history reference occurs when the first nonblank character of an input line is 
a“. This is equivalent to !:s*, providing a convenient shorthand for substitutions on the text of the pre- 
vious line. Thus “lb‘lib fixes the spelling of lib in the previous command. Finally, a history substitution 
may be surrounded with { and } if necessary to insulate it from the characters that follow. Thus, after Is 
—ld “paul we might do !{I}a to do ls —Id “paula, while !la would look for a command starting la. 


Quotations With ° and " 


The quotation of strings by “ and " can be used to prevent all or some of the remaining substitutions. 
Strings enclosed in ° are prevented any further interpretation. Strings enclosed in " are variable and 
command expansion may occur. 


In both cases, the resulting text becomes (all or part of) a single word; only in one special case (see 
Command Substitution below) does a " quoted string yield parts of more than one word; ’ quoted strings 
never do. 
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Alias Substitution 


The shell maintains a list of aliases which can be established, displayed and modified by the alias and 
unalias commands. After a command line is scanned, it is parsed into distinct commands and the first 
word of each command, left-to-right, is checked to see if it has an alias. If it does, then the text which 
is the alias for that command is reread with the history mechanism available as though that command 
were the previous input line. The resulting words replace the command and argument list. If no re- 
ference is made to the history list, then the argument list is left unchanged. 


Thus if the alias for ls is ls —1 the command “Is /usr” would map to “ls —1 /usr’. Similarly if the alias 
for lookup was “grep !" /etc/passwd” then “lookup bill” would map to “grep bill /etc/passwd”’. 


If an alias is found, the word transformation of the input text is performed and the aliasing process be- 
gins again on the reformed input line. Looping is prevented if the first word of the new text is the same 
as the old by flagging it to prevent further aliasing. Other loops are detected and cause an error. 


(Ti4 


Note that the mechanism allows aliases to introduce parser metasyntax. Thus we can alias print “pr \!* 


| lpr”? to make a command that paginates its arguments to the lineprinter. 
Variable Substitution 


The shell maintains a set of variables, each of which has as value a list of zero or more words. Some of 
these variables are set by the shell or referred to by it. For instance, the argv variable is an image of 
the shell’s argument list, and words of this variable’s value are referred to in special ways. 


The values of variables may be displayed and changed by using the set and unset commands. Of the 
variables referred to by the shell a number are toggles; the shell does not care what their value is, only 
whether they are set or not. For instance, the verbose variable is a toggle which causes command input 
to be echoed. The setting of this variable results from the —v command line option. 


Other operations treat variables numerically. The at-sign (@) command permits numeric calculations to 
be performed and the result assigned to a variable. However, variable values are always represented as 
(zero or more) strings. For the purposes of numeric operations, the null string is considered to be zero, 
and the second and subsequent words of multiword values are ignored. 


After the input line is aliased and parsed, and before each command is executed, variable substitution is 
performed, keyed by dollar sign ($) characters. This expansion can be prevented by preceding the dollar 
sign with a backslash (\) except within double quotation marks (") where it a/ways occurs, and within 
single quotation marks (") where it never occurs. Strings quoted by back quotation marks (°) are inter- 
preted later (see Command substitution below) so dollar sign substitution does not occur there until 
later, if at all. A dollar sign is passed unchanged if followed by a blank, tab, or end-of-line. 


Input and output redirections are recognized before variable expansion, and are variable expanded 
separately. Otherwise, the command name and entire argument list are expanded together. It is thus 
possible for the first (command) word to generate more than one word, the first of which becomes the 
command name, and the rest of which become arguments. 


Unless enclosed in double quotation marks or given the :q modifier, the results of variable substitution 
may eventually be command and filename substituted. Within double quotation marks (") a variable 
whose value consists of multiple words expands to a portion of a single word, with the words of the vari- 
able’s value separated by blanks. When the :q modifier is applied to a substitution the variable expands 
to multiple words with each word separated by a blank and quoted to prevent later command or filename 
substitution. 


The following sequences are provided for introducing variable values into the shell input. Except as 
noted, it is an error to reference a variable which is not set. 
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$name 

${name} 
Are replaced by the words of the value of variable name, each separated by a blank. Braces insu- 
late name from following characters which would otherwise be part of it. Shell variables have 
names consisting of up to 20 letters, digits, and underscores. 


If name is not a shell variable, but is set in the environment, then that value is returned (but : modifiers 
and the other forms given below are not available in this case). 


$name[selector] 

${name[selector]} 
May be used to select only some of the words from the value of name. The selector is subjected to 
$ substitution and may consist of a single number or two numbers separated by a —. The first 


word of a variables value is numbered 1. If the first number of a range is omitted it defaults to 1. 
If the last member of a range is omitted it defaults to $4name. The selector * selects all words. It 
is not an error for a range to be empty if the second argument is omitted or in range. 


$#name 


${#name} 


e 
Gives the number of words in the variable. This is useful for later use in a [selector]. 


$0 Substitutes the name of the file from which command input is being read. An error occurs if the 
name is not known. 


$number 
${number} 
Equivalent to $argv[number]. 


$* Equivalent to $argv[*]. 


The modifiers :h, :t, :r, :q and :x may be applied to the substitutions above as may :gh, :gt and :gr. If 
braces { } appear in the command form then the modifiers must appear within the braces. Only one : 
modifier is allowed on each $ expansion. 


The following substitutions may not be modified with : modifiers. 


$?name 
${?name} 
Substitutes the string 1 if name is set, 0 if it is not. 


$?0 Substitutes 1 if the current input filename is known, 0 if it is not. 
$$ Substitutes the (decimal) process number of the (parent) shell. 
Command and Filename Substitution 


Command and filename substitution are applied selectively to the arguments of built-in commands. This 
means that portions of expressions which are not evaluated are not subjected to these expansions. For 
commands which are not internal to the shell, the command name is substituted separately from the ar- 
gument list. This occurs very late, after input-output redirection is performed, and in a child of the 
main shell. 


Command Substitution 


Command substitution is indicated by a command enclosed in back quotation marks. The output from 
such a command is normally broken into separate words at blanks, tabs and newlines, with null words 
being discarded, this text then replacing the original string. Within double quotation marks, only new- 
lines force new words; blanks and tabs are preserved. 
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In any case, the single final newline does not force a new word. Note that it is thus possible for a com- 
mand substitution to yield only part of a word, even if the command outputs a complete line. 


Filename Substitution 


If a word contains any of the characters *, ?, [ or { or begins with the character ~, then that word is a 
candidate for filename substitution, also known as globbing. This word is then regarded as a pattern, 
and replaced with an alphabetically sorted list of filenames which match the pattern. In a list of words 
specifying filename substitution it is an error for no pattern to match an existing filename, but it is not 
required for each pattern to match. Only the metacharacters *, ?, and [ imply pattern matching, the 
characters ~ and { being more akin to abbreviations. 


In matching filenames, the character . at the beginning of a filename or immediately following a /, as 
well as the character / must be matched explicitly. The character * matches any string of characters, 
including the null string. The character ? matches any single character. The sequence [...] matches any 
one of the characters enclosed. Within [...], a pair of characters separated by — matches any character 
lexically between the two. 


The character ~ at the beginning of a filename is used to refer to home directories. Standing alone it ex- 
pands to the invoker’s home directory as reflected in the value of the variable home. When followed by a 
name consisting of letters, digits and — characters the shell searches for a user with that name and sub- 
stitutes their home directory; thus “ken might expand to /usr/ken and “ken/chmach to 
/usr/ken/chmach. If the character ~ is followed by a character other than a letter or / or appears not 
at the beginning of a word, it is left unchanged. 


The metanotation a{b,c,d}e is a shorthand for abe ace ade. Left to right order is preserved, with results 
of matches being sorted separately at a low level to preserve this order. This construct may be nested. 
Thus “source/s1/{oldls,ls}.c expands to /usr/source/s1/oldls.c /usr/source/s1/ls.c, whether or not these 
files exist, without any chance of error if the home directory for source is /usr/source. Similarly 
../{memo,*box} might expand to ../memo ../box ../mbox. (Note that memo was not sorted with the 
results of matching *box.) As a special case {, } and {} are passed unchanged. 


Input/Output 
The standard input and standard output of a command may be redirected with the following syntax: 


< name 
Opens file name (which is first variable, command and filename expanded) as the standard input. 


<< word 

Reads the shell input up to a line which is identical to word. Word is not subjected to variable, 
filename or command substitution, and each input line is compared to word before any substitu- 
tions are done on this input line. Unless a quoting backslash, double, or single quotation mark, or 
a back quotation mark appears in word, variable and command substitution is performed on the 
intervening lines, allowing \ to quote $, \ and «. Commands which are substituted have all blanks, 
tabs, and newlines preserved, except for the final newline which is dropped. The resulting text is 
placed in an anonymous temporary file which is given to the command as standard input. 


> name 

>! name 

> & name 

> &! name 
The file name is used as standard output. If the file does not exist then it is created; if the file ex- 
ists, it is truncated, and its previous contents is lost. 


If the variable noclobber is set, then the file must not already exist or it must be a character 
special file (e.g. a terminal or /dev/null) or an error results. This helps prevent accidental 
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destruction of files. In this case the ! forms can be used and suppress this check. 


The forms involving & route the diagnostic output into the specified file as well as the standard 
output. Name is expanded in the same way as < input filenames are. 


>> name 

>> & name 

>>! name 

>> &! name 
Uses file name as standard output like > but places output at the end of the file. If the variable 
noclobber is set, then it is an error for the file not to exist unless one of the ! forms is given. Oth- 
erwise similar to >. 


If a command is run detached (followed by &) then the default standard input for the command is the 
empty file /dev/null. Otherwise the command receives the environment in which the shell was invoked 
as modified by the input-output parameters and the presence of the command in a pipeline. Thus, un- 
like some previous shells, commands run from a file of shell commands have no access to the text of the 
commands by default; rather they receive the original standard input of the shell. The << mechanism 
should be used to present inline data. This permits shell command scripts to function as components of 
pipelines and allows the shell to block read its input. 


Diagnostic output may be directed through a pipe with the standard output. Simply use the form |& 
rather than just | 


Expressions 


A number of the built-in commands (to be described later) take expressions, in which the operators are 
similar to those of C, with the same precedence. These expressions appear in the @, exit, if, and while 
commands. The following operators are available: 


| && | 7 & == != <= >= < > << >> 
+—+/%!"~*() 


Here the precedence increases to the right, == and !=, <=, >=, <, and >, << and >>, + and -, * 
/ and % being, in groups, at the same level. The == and != operators compare their arguments as 
strings, all others operate on numbers. Strings which begin with 0 are considered octal numbers. Null 
or missing arguments are considered 0. The result of all expressions are strings, which represent decimal 
numbers. It is important to note that no two components of an expression can appear in the same word; 
except when adjacent to components of expressions which are syntactically significant to the parser (& | 
< > ()) they should be surrounded by spaces. 


Also available in expressions as primitive operands are command executions enclosed in { and } and file 
enquiries of the form —/ name where / is one of: 


Read access 
Write access 
Execute access 
Existence 
Ownership 
Zero size 
Plain file 
Directory 


Qa™mNOOrx = 


The specified name is command and filename expanded, then tested to see if it has the specified rela- 
tionship to the real user. If the file does not exist or is inaccessible then all enquiries return false, i.e. 0. 
Command executions succeed, returning true, i.e. 1, if the command exits with status 0, otherwise they 
fail, returning false, i.e. 0. If more detailed status information is required then the command should be 
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executed outside of an expression and the variable status examined. 
Control Flow 


The shell contains a number of commands which can be used to regulate the flow of control in command 
files (shell scripts) and (in limited but useful ways) from terminal input. These commands all operate 
by forcing the shell to reread or skip in its input and, due to the implementation, restrict the placement 
of some of the commands. 


The foreach, switch, and while statements, as well as the if—then—else form of the if statement require 
that the major keywords appear in a single simple command on an input line as shown below. 


If the shell’s input is not seekable, the shell buffers up input whenever a loop is being read and performs 
seeks in this internal buffer to accomplish the rereading implied by the loop. (To the extent that this al- 
lows, backward goto commands will succeed on nonseekable inputs.) 


Built-In Commands 


Built-in commands are executed within the shell. If a built-in command occurs as any component of a 
pipeline except the last then it is executed in a subshell. 


alias 

alias name 

alias name wordlist 
The first form prints all aliases. The second form prints the alias for name . The final form assigns 
the specified wordlist as the alias of name; wordlist is command and filename substituted. Name 
is not allowed to be alias or unalias 


break 
Causes execution to resume after the end of the nearest enclosing foreach or while statement. The 
remaining commands on the current line are executed. Multilevel breaks are thus possible by wri- 
ting them all on one line. 


breaksw 
Causes a break from a switch, resuming after the endsw. 


case label: 
A label in a switch statement as discussed below. 


cd 

cd name 

chdir 

chdir name 
Changes the shell’s working directory to directory name. If no argument is given then changes to 
the home directory of the user. If name is not found as a subdirectory of the current directory 
(and does not begin with /, ./, or ../), then each component of the variable cdpath is checked to 
see if it has a subdirectory name. Finally, if all else fails but name is a shell variable whose value 
begins with /, then this is tried to see if it is a directory. 


continue 
Continues execution of the nearest enclosing while or foreach. The rest of the commands on the 
current line are executed. 


default: 
Labels the default case in a switch statement. The default should come after all case labels. 
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echo wordlist 
The specified words are written to the shell’s standard output. An \c causes the echo to complete 
without printing a newline. An \n in wordlist causes a newline to be printed. Otherwise the words 
are echoed, separated by spaces. 


else 
end 
endif 
endsw 
See the description of the foreach, if, switch, and while statements below. 


exec command 
The specified command is executed in place of the current shell. 


exit 

exit(expr) 
The shell exits either with the value of the status variable (first form) or with the value of the 
specified expr (second form). 


foreach name (wordlist) 


end 
The variable name is successively set to each member of wordlist and the sequence of commands 
between this command and the matching end are executed. (Both foreach and end must appear 
alone on separate lines.) 


The built-in command continue may be used to continue the loop prematurely and the built-in 
command break to terminate it prematurely. When this command is read from the terminal, the 
loop is read up once prompting with ? before any statements in the loop are executed. 


glob wordlist 
Like echo but no \ escapes are recognized and words are delimited by null characters in the 
output. Useful for programs which wish to use the shell to filename expand a list of words. 


goto word 
The specified word is filename and command expanded to yield a string of the form label. The 
shell rewinds its input as much as possible and searches for a line of the form label: possibly pre- 
ceded by blanks or tabs. Execution continues after the specified line. 


history 
Displays the history event list. 


if (expr) command 
If the specified expression evaluates true, then the single command with arguments is executed. 
Variable substitution on command happens early, at the same time it does for the rest of the if 
command. Command must be a simple command, not a pipeline, a command list, or a 
parenthesized command list. Input/output redirection occurs even if expr is false, when command 
is not executed. 


if (expr) then 
else if (expr2) then 
else 


endif 
If the specified expr is true then the commands to the first e/se are executed; else if expr2 is true 
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then the commands to the second else are executed, etc. Any number of else-if pairs are possible; 
only one endif is needed. The else part is likewise optional. (The words else and endif must ap- 
pear at the beginning of input lines; the if must appear alone on its input line or after an else.) lo- 
gout 

Terminates a login shell. The only way to log out if ignoreeof is set. 


nice 

nice +number 

nice command 

nice +number command 
The first form sets the nice for this shell to 4. The second form sets the nice to the given number. 
The final two forms run command at priority 4 and number respectively. The super-user may 
specify negative niceness by using “nice —number ....” The command is always executed in a 
subshell, and the restrictions placed on commands in simple if statements apply. 


nohup 

nohup command 
The first form can be used in shell scripts to cause hangups to be ignored for the remainder of the 
script. The second form causes the specified command to be run with hangups ignored. Unless 
the shell is running detached, nohup has no effect. All processes detached with & are automati- 
cally nohuped. (Thus, nohup is not really needed.) 


onintr 

onintr — 

onintr label 
Controls the action of the shell on interrupts. The first form restores the default action of the shell 
on interrupts which is to terminate shell scripts or to return to the terminal command input level. 
The second form onintr — causes all interrupts to be ignored. The final form causes the shell to 
execute a goto label when an interrupt is received or a child process terminates because it was in- 
terrupted. 


In any case, if the shell is running detached and interrupts are being ignored, all forms of onintr 
have no meaning and interrupts continue to be ignored by the shell and all invoked commands. 


rehash 
Causes the internal hash table of the contents of the directories in the path variable to be recom- 
puted. This is needed if new commands are added to directories in the path while you are logged 
in. This should only be necessary if you add commands to one of your own directories, or if a sys- 
tems programmer changes the contents of one of the system directories. 


repeat count command 
The specified command which is subject to the same restrictions as the command in the one line if 
statement above, is executed count times. I/O redirections occurs exactly once, even if count is 0. 


set 

set name 

set name=word 

set name[index]=word 

set name=(wordlist) 
The first form of the command shows the value of all shell variables. Variables which have other 
than a single word as value print as a parenthesized word list. The second form sets name to the 
null string. The third form sets name to the single word. The fourth form sets the indexth com- 
ponent of name to word; this component must already exist. The final form sets name to the list of 
words in wordlist. In all cases the value is command and filename expanded. 
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These arguments may be repeated to set multiple values in a single set command. Note however, 
that variable expansion happens for all arguments before any setting occurs. 


setenv name value 
Sets the value of the environment variable name to be value, a single string. Useful environment 
variables are TERM, the type of your terminal and SHELL, the shell you are using. 


shift 

shift variable 
The members of argv are shifted to the left, discarding argv/1/. It is an error for argv not to be set 
or to have less than one word as value. The second form performs the same function on the 
specified variable. 


source name 
The shell reads commands from name. Source commands may be nested; if they are nested too 
deeply the shell may run out of file descriptors. An error in a source at any level terminates all 
nested source commands. Input during source commands is never placed on the history list. 


switch (string) 
case strl: 


breaksw 
default: 


breaksw 
endsw 
Each case label is successively matched, against the specified string which is first command and 
filename expanded. The file metacharacters *, ?, and [...] may be used in the case labels, which 
are variable expanded. If none of the labels match before a default label is found, then the execu- 
tion begins after the default label. Each case label and the default label must appear at the begin- 
ning of a line. The command breaksw causes execution to continue after the endsw. Otherwise 
control may fall through case labels and default labels, as in C. If no label matches and there is 
no default, execution continues after the endsw. 


time 

time command 
With no argument, a summary of time used by this shell and its children is printed. If arguments 
are given the specified simple command is timed and a time summary as described under the time 
variable is printed. If necessary, an extra shell is created to print the time statistic when the com- 
mand completes. 


umask 

umask value 
The file creation mask is displayed (first form) or set to the specified value (second form). The 
mask is given in octal. Common values for the mask are 002 giving all access to the group and 
read and execute access to others, or 022 giving all access except no write access for users in the 
group or others. 


unalias pattern 
All aliases whose names match the specified pattern are discarded. Thus all aliases are removed 


by unalias *. It is not an error for nothing to be wnaliased. 


unhash 
Use of the internal hash table to speed location of executed programs is disabled. 
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unset pattern 
All variables whose names match the specified pattern are removed. Thus all variables are 
removed by unset *; this has noticeably distasteful side-effects. It is not an error for nothing to be 
unset. | 


wait 
All child processes are waited for. It the shell is interactive, then an interrupt can disrupt the 
wait, at which time the shell prints names and process numbers of all children known to be 
outstanding. 


while (expr) 


end 
While the specified expression evaluates nonzero, the commands between the while and the 
matching end are evaluated. Break and continue may be used to terminate or continue the loop 
prematurely. (The while and end must appear alone on their input lines.) Prompting occurs here 
the first time through the loop as for the foreach statement if the input is a terminal. 

@ 


@ name = expr 

@ name[index] = expr 
The first form prints the values of all the shell variables. The second form sets the specified name 
to the value of expr. If the expression contains <, >, & or | then at least this part of the expres- 
sion must be placed within ( ). The third form assigns the value of expr to the indexth argument 
of name. Both name and its indexth component must already exist. 


The operators *=, +=, etc. are available as in C. The space separating the name from the assign- 
ment operator is optional. Spaces are mandatory in separating components of expr which would 
otherwise be single words. 


Special postfix ++ and —— operators increment and decrement name respectively, i.e. @ i++. 
Predefined Variables 


The following variables have special meaning to the shell. Of these, argv, child, home, path, prompt, 
Shell and status are always set by the shell. Except for child and status this setting occurs only at ini- 
tialization; these variables will not then be modified unless done explicitly by the user. 


The shell copies the environment variable PATH into the variable path, and copies the value back into 
the environment whenever path is set. Thus is is not necessary to worry about its setting other than in 
the file .cshre as inferior csh processes will import the definition of path from the environment. 


argy Set to the arguments to the shell, it is from this variable that positional parameters are 
substituted, i.e. $1 is replaced by $argv[1], etc. 


cdpath Gives a list of alternate directories searched to find subdirectories in cd commands. 


child The process number printed when the last command was forked with &. This variable 
is unset when this process terminates. 


echo Set when the —x command line option is given. Causes each command and its argu- 
ments to be echoed just before it is executed. For nonbuilt-in commands all expansions 
occur before echoing. Builtin commands are echoed before command and filename 
substitution, since these substitutions are then done selectively. 


histchars Can be assigned a two-character string. The first character is used as a history 
character in place of !, the second character is used in place of the ~ substitution 
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nonomatch 


path 


prompt 


shell 
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mechanism. For example, set histchars=",;" will cause the history characters to be 
comma and semicolon. 


Can be given a numeric value to control the size of the history list. Any command 
which has been referenced in this many events will not be discarded. A history that is 
too large may run the shell out of memory. The last executed command is always 
saved on the history list. 


The home directory of the invoker, initialized from the environment. The filename ex- 


pansion of ~ refers to this variable. 


If set the shell ignores end-of-file from input devices that are terminals. This prevents 
a shell from accidentally being terminated by typing a CNTRL-D. 


The files where the shell checks for mail. This is done after each command completion 
which will result in a prompt, if a specified interval has elapsed. The shell says “You 
have new mail”. if the file exists with an access time not greater than its modify time. 


If the first word of the value of mail is numeric it specifies a different mail checking in- 
terval, in seconds, than the default, which is 10 minutes. 


If multiple mail files are specified, then the shell says ‘““New mail in name” when there 
is mail in the file name. 


As described in the section Jnput/output, restrictions are placed on output redirection 
to insure that files are not accidentally destroyed, and that >> redirections refer to 
existing files. 


If set, filename expansion is inhibited. This is most useful in shell scripts which are not 
dealing with filenames, or after a list of filenames has been obtained and further expan- 
sions are not desirable. 


If set, it is not an error for a filename expansion to not match any existing files; rather, 
the primitive pattern is returned. It is still an error for the primitive pattern to be mal- 
formed, i.e. echo [ still gives an error. 


Each word of the path variable specifies a directory in which commands are to be 
sought for execution. A null word specifies the current directory. If there is no path 
variable then only full pathnames will execute. The usual search path is /bin, 
/usr/bin, and ., but this may vary from system to system. For the super-user the de- 
fault search path is /etc, /bin and /usr/bin. A shell which is given neither the —e nor 
the —t option will normally hash the contents of the directories in the path variable 
after reading .cshrc, and each time the path variable is reset. If new commands are 
added to these directories while the shell is active, it may be necessary to give the 
rehash or the commands may not be found. 


The string which is printed before each command is read from an interactive terminal 
input. If a ! appears in the string it will be replaced by the current event number 
unless a preceding \ is given. Default is % , or # for the super-user. 


The file in which the shell resides. This is used in forking shells to interpret files which 
have execute bits set, but which are not executable by the system. (See the description 
of Nonbuilt-In Command Execution below.) Initialized to the (system-dependent) 
home of the shell. 


The status returned by the last command. If it terminated abnormally, then 0200 is 
added to the status. Built-in commands which fail return exit status 1, all other built- 
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in commands set status 0. 


time Controls automatic timing of commands. If set, then any command which takes more WY 
than this many cpu seconds will cause a line giving user, system, and real times and a 
utilization percentage which is the ratio of user plus system times to real time to be 
printed when it terminates. 


verbose Set by the —vy command line option, causes the words of each command to be printed 
after history substitution. 


Nonbuilt-In Command Execution 


When a command to be executed is found to not be a built-in command the shell attempts to execute 
the command via exec(S). Each word in the variable path names a directory from which the shell will 
attempt to execute the command. If it is given neither a —e nor a —t option, the shell will hash the 
names in these directories into an internal table so that it will only try an exec in a directory if there is a 
possibility that the command resides there. This greatly speeds command location when a large number 
of directories are present in the search path. If this mechanism has been turned off (via unhash), or if 
the shell was given a —c or —t argument, and in any case for each directory component of path which 
does not begin with a /, the shell concatenates with the given command name to form a pathname of a 
file which it then attempts to execute. 


Parenthesized commands are always executed in a subshell. Thus (cd ; pwd) ; pwd prints the home 
directory; leaving you where you were (printing this after the home directory), while cd ; pwd leaves you 
in the home directory. Parenthesized commands are most often used to prevent cd from affecting the 
current shell. 


If the file has execute permissions but is not an executable binary to the system, then it is assumed to be 
a file containing shell commands an a new shell is spawned to read it. ) 


If there is an alias for shell then the words of the alias will be prepended to the argument list to form 
the shell command. The first word of the alias should be the full pathname of the shell (e.g. $shell). 
Note that this is a special, late occurring, case of alias substitution, and only allows words to be 
prepended to the argument list without modification. 


Argument List Processing 
If argument 0 to the shell is — then this is a login shell. The flag arguments are interpreted as follows: 


—c Commands are read from the (single) following argument which must be present. Any remaining 
arguments are placed in argv. 


—e The shell exits if any invoked command terminates abnormally or yields a nonzero exit status. 


—f The shell will start faster, because it will neither search for nor execute commands from the file 
.cshre in the invoker’s home directory. 


—i The shell is interactive and prompts for its top-level input, even if it appears to not be a terminal. 
Shells are interactive without this option if their inputs and outputs are terminals. 


—n Commands are parsed, but not executed. This may aid in syntactic checking of shell scripts. 
—s Command input is taken from the standard input. 


—t A single line of input is read and executed. A \ may be used to escape the newline at the end of 
this line and continue onto another line. 


U9 
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—vy Causes the verbose variable to be set, with the effect that command input is echoed after history 
substitution. 


—x Causes the echo variable to be set, so that commands are echoed immediately before execution. 
—V Causes the verbose variable to be set even before .cshrc is executed. 
—X Causes the echo variable to be set even before .cshrc is executed. 


After processing of flag arguments, if arguments remain but none of the —c, —i, —s, or —t options were 
given, the first argument is taken as the name of a file of commands to be executed. The shell opens 
this file, and saves its name for possible resubstitution by $0. Since on a typical system most shell 
scripts are written for the standard shell (see sh(C)), the C shell will execute such a standard shell if the 
first character of a script is not a #, i.e. if the script does not start with a comment. Remaining argu- 
ments initialize the variable argv. 


Signal Handling 


The shell normally ignores quit signals. The interrupt and quit signals are ignored for an invoked com- 
mand if the command is followed by &; otherwise the signals have the values which the shell inherited 
from its parent. The shells handling of interrupts can be controlled by onintr. Login shells catch the ter- 
minate signal; otherwise this signal is passed on to children from the state in the shell’s parent. In no 
case are interrupts allowed when a login shell is reading the file .logout. 


Files 
~/.cshre Read at by each shell at the beginning 
of execution 
~/ login Read by login shell, after .cshre at login 
“/ logout Read by login shell, at logout 
/bin/sh Shell for scripts not starting with a # 
/tmp/sh* Temporary file for << 
/dev/null Source of empty file 
/etc/passwd Source of home directories for “name 
Limitations 


Words can be no longer than 512 characters. The number of arguments to a command which involves 
filename expansion is limited to 1/6 number of characters allowed in an argument list, which is 5120, 
less the characters in the environment. Also, command substitutions may substitute no more characters 
than are allowed in an argument list. 


To detect looping, the shell restricts the number of alias substitutions on a single line to 20. 


See Also 


access(S), exec(S), fork(S), pipe(S), signal(S), umask(S), wait(S), a.out(F), environ(F) 
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Credit 


This utility was developed at the University of California at Berkeley and is used with permission. 


Notes 
Built-in control structure commands like foreach and while cannot be used with | & or ;. 
Commands within loops, prompted for by ?, are not placed in the history list. 
It is not possible to use the colon (:) modifiers on the output of command substitutions. 


Csh attempts to import and export the PATH variable for use with regular shell scripts. This only works 
for simple cases, where the PATH contains no command characters. 


This version of csh does not support or use the process control features of the 4th Berkeley Distribution. 
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Name 


csplit — Splits files according to context. 


Syntax 


csplit [—s] [—k] [—f prefix] file arg] [... argn] 


Description 


Csplit reads file and separates it into n+1 sections, defined by the arguments arg]... argn. By default 
the sections are placed in xx00 ... xxn (n may not be greater than 99). These sections get the fol- 
lowing pieces of file: 


00: From the start of file up to (but not including) the line referenced by arg!. 


01: From the line referenced by arg/ up to the line referenced by arg2. 


n+1: From the line referenced by argn to the end of file. 
The options to csplit are: 


—S Csplit normally prints the character counts for each file created. If the —s option is present, 
csplit suppresses the printing of all character counts. 


om —k Csplit normally removes created files if an error occurs. If the —k option is present, csplit 
leaves previously created files intact. 


—f prefix If the —f option is used, the created files are named prefix00 ... prefixn. The default is xx00 
pois Mt, 


The arguments (arg] ... argn) to csplit can be a combination of the following: 


/rexp/ A file is to be created for the section from the current line up to (but not including) the line 
containing the regular expression rexp. The current line becomes the line containing rexp. 
This argument may be followed by an optional tor — some number of lines (e.g., /Page/—5). 


Yorexp% This argument is the same as /rexp/, except that no file is created for the section. 


Inno A file is to be created from the current line up to (but not including) /nno. The current line 
becomes /nno. 


{num} Repeat argument. This argument may follow any of the above arguments. If it follows a rexp 
type argument, that argument is applied num more times. If it follows /nno, the file will be 
split every /nno lines (num times) from that point. 


Enclose all rexp type arguments that contain blanks or other characters meaningful to the shell in the 
appropriate quotation marks. Regular expressions may not contain embedded newlines. Csplit does not 
affect the original file; it is the users responsibility to remove it. 


Examples 


cy csplit —f cobol file ‘/procedure division/' /parS./ /par16./ 


This example creates four files, cobol00 ... cobol03. After editing the “split” files, they can be 
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recombined as follows: 
cat cobol0[0—3] > file 

Note that this example overwrites the original file. 
csplit —k file 100 {99} 


This example would split the file at every 100 lines, up to 10,000 lines. The —k option causes the 
created files to be retained if there are less than 10,000 lines; however, an error message would still be 
printed. 


esplit —k prog.c '%main(%' '/*}/+1' {20} 
Assuming that prog.c follows the normal C coding convention of ending routines with a } at the begin- 
ning of the line, this example will create a file containing each separate C routine (up to 21) in prog.c. 
See Also 


ed(C), sh(C), regex(S) 


Diagnostics 
Self-explanatory except for: 
arg — out of range 


which means that the given argument did not reference a line between the current position and the end 
of the file. 
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Name 


cu — call up XENIX 


Syntax 


cu telno [ —t ] [ —s speed ] [ —a acu ] [ —l line ] [ —nh ] 


Description 


Cu calls up another XENIX system, a terminal, or possibly a non-XENIX system. It manages an in- 
teractive conversation with possible transfers of text files. Telno is the telephone number, with minus 
signs at appropriate places for delays, or ‘wait’, to indicate a manual connection. If ‘wait’ is specified, 
‘/dev/null’ is used as the dial unit and cu waits up to five minutes for the carrier to turn on. The —t 
flag is used to dial out to a terminal. Speed gives the transmission speed (110, 134, 150, 300, 600, 
1200, 2400, 4800, 9600); 300 is the default value. The —nh flag prevents cu from hanging up the ter- 
minal line upon exit. 


The —a and —I values may be used to specify pathnames for the ACU and communications line devices. 
They can be used to override the following built-in choices: 


—a /dev/cua0 —1 /dev/culO 


After making the connection, cu runs as two processes: the send process reads the standard input and 
passes most of it to the remote system; the receive process reads from the remote system and passes most 
data to the standard output. Lines beginning with “” have special meanings. 


The send process interprets the following: 


~ 


: terminate the conversation. 
“EOT terminate the conversation 


~<file send the contents of file to the remote system, as though typed at the terminal. 
e invoke an interactive shell on the local system. 

“Terni; run the command on the local system (via sh —c). 

“Scmid..... run the command locally and send its output to the remote system. 


“%take from [to] copy file ‘from’ (on the remote system) to file ‘to’ on the local system. If ‘to’ is om- 
itted, the ‘from’ name is used both places. 


“%put from [to] copy file ‘from’ (on local system) to file ‘to’ on remote system. If ‘to’ is omitted, the 
‘from’ name is used both places. 


“Yspeed n set speed of transmission line to ‘n’, where n is one of 110, 134, 150, 300, 600, 
1200, 2400, 4800, 9600. 


send the line ‘*...’. 


The receive process handles output diversions of the following form: 


“one |e] Ble 
zero or more lines to be written to file 
sem 
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In any case, output is diverted (or appended, if ‘>>’ used) to the file. If ‘:’ is used, the diversion is 
silent, i.e., it is written only to the file. If‘: is omitted, output is written both to the file and to the stan- 7, 
dard output. The trailing ““>’ terminates the diversion. 


The use of ~“% put requires stty and cat on the remote side. It also requires that the current erase and 
kill characters on the remote system be identical to the current ones on the local system. Backslashes 
are inserted at appropriate places. 


The use of ~% take requires the existence of echo and tee on the remote system. Also, stty tabs mode is 
required on the remote system if tabs are to be copied without expansion. 
Files 


/dev/cuad 
/dev/cul0 
/dev/null 


See Also 


ser(M), tty(M) 


Diagnostics 


Exit code is zero for normal exit, nonzero (various values) otherwise. 


Notes VY 


The syntax is unique. 
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Name 


cu.s3 — Calls another XENIX system. 


Syntax 
cu.s3 [-sspeed] [-aacu] [-Iline] [-h] [-o|-e] telno 


cu.s3 [-sspeed ] [ -line | [-h] [-ol-e] dir 


Description 


Cu.s3 “calls up” another XENIX system through a modem or a direct serial connection. It also controls 
the transmission and reception of data and programs during the call. Cu.s3 looks at each line in the file 
/usr /lib/uucp/L-devices until it finds a line that matches the options given in the command line. If it 
finds an appropriate line, it will attempt to make a connection. If it cannot find the proper line, cu.s3 
quits. 


The options are: 


—sspeed 
Specifies the transmission speed. 1200 baud is the default value. Other speeds available are 110, 
150, 300, 1200, 2400, 4800 and 9600 baud. Directly connected lines may be set to other speeds. 
Most modems are restricted to 300 and 1200 baud. 


—aacu 
Specifies the device name of the ACU (automatic calling unit) device. If not specified, cu.s3 will 
use the first available acu with the right speed. 


Beene the device name of the communications line. If not specified, cu.s3 will use the first 
available direct line (if dir is specified) or acu (if a telno is specified) with the right speed. 

—h Emulates local echo. This feature supports calls to systems that expect half-duplex mode terminals. 

—e Specifies that even-parity data is to be generated for data sent to the remote system. 

—o Specifies that odd-parity data is to be generated for data sent to the remote system. 


Telno is the telephone number of the remote system. 


For acu connections, cu.s3 invokes /usr/lib/uucp/dial to dial the modem. Consult your modem manual 
to determine the correct sequences to include in the phone number for pauses, pulse dialing, etc. 


For directly connected lines, the string “dir” is used instead of te/no. See the Examples later in this sec- 
tion for sample command lines. 


After making the connection, cu.s3 runs as two processes: transmit and receive. The transmit process 
reads data from the standard input and, except for lines beginning with a tilde (~), passes it to the 
remote system. The receive process accepts data from the remote system and, except for lines beginning 
with a tilde, passes it to the standard output. Normally, an automatic XON/XOFF (DC3/DC1) protocol 
controls input from the remote system so the buffer is not overrun. Lines beginning with a tilde have 
special meanings. 


The transmit process interprets lines beginning with a tilde as follows: 
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Terminates the conversation. 


a Escapes to an interactive shell on the local system. 
SORid <>. Runs cmd on the local system (via sh -c). 
“$cmd... Runs cmd locally and sends its output to the remote system. 


~% take remote [ local | 
Copies file remote (on the remote system) to file Jocal on the local system. If 
local is omitted, the remote filename is used in both places. Use of this line re- 
quires the existence of echo(C) and cat(C) on the remote system. If tabs are to 
be copied without expansion, stty tabs mode should be set on the remote system. 


~% put local | remote | 
Copies file /ocal (on the local system) to file remote on the remote system. If 
local is omitted, the remote filename is used in both places. Use of this line re- 
quires the existence of stty(C) and cat(C) on the remote system. It also re- 
quires that the current erase and kill characters on the remote system be iden- 
tical to the current ones on the local system. Backslashes are inserted at ap- 
propriate places. 


ek Sends the line ~... to the remote system. 


~% nostop Turns off the XON/XOFF input control protocol for the remainder of the session. 
This is useful if the remote system is one which does not respond properly to the 
XON/XOFF characters. 


The receive process normally copies data from the remote system to its standard output. A line from 
the remote system that begins with “> diverts the output to a file. Data is appended to a file if “>> is 
used. The diversion is terminated by a trailing “>. The complete sequence is: 


"> L> lefle 
zero or more lines to be written to file 
a 
Examples 
A sample command for a dialup connection is: 
cu 5559801 
Cu.s3 will select the first available acu at the default speed of 1200 baud. 
A sample command for a direct connection is: 
cu.s3 dir 


Cu.s3 will select the first available direct line at the default speed of 1200 baud. 


You can force cu.s3 to use a specific acu device, line device or speed with the command line options -a, 
-l and -s. This is useful if you wish to use the same modem for dialup connections at both 300 and 1200 
baud, or if you have more than one directly connected computer. For example: 


cu.s3 -a tty12 -s 300 5559801 


will force cu.s3 to place the call through /dev/tty12 at 300 baud. 
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cu.s3 -l tty12 dir 


will cause /dev/tty12 to be used for a direct connection at 1200 baud. 


Files 
/usr /lib/uucp/L-devices Device information 
/usr/lib/uucp/dial Dialer program 
See Also 


cat(C), echo(C), stty(C), tty(M) 
Diagnostics 
Exit code is zero for normal exit, nonzero (various values) otherwise. 


Device busy: Someone else is using the desired line. 


Notes 


There is an artificial slowing of transmission by cu.s3 during the ~% put operation so that loss of data is 
unlikely. 


ASCII files only can be transferred using ~% take or ~% put; binary files cannot be transferred. 


Cu.s3 opens devices for exclusive use. If cu.s3 terminates abnormally, the device may remain locked. 
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Name 


date — Prints and sets the date. 


Syntax 


date [ mmddhhmm|[yy] ] [ +format ] 


Description 


If no argument is given, or if the argument begins with +, the current date and time are printed. Oth- 
erwise, the current date is set. The first mm is the month number; dd is the day number in the month; 
hh is the hour number (24-hour system); the second mm is the minute number; yy is the last 2 digits of 
the year number and is optional. For example: 


date 10080045 


sets the date to Oct 8, 12:45 AM. The current year is the default if no year is mentioned. The system 
operates in GMT. Date takes care of the conversion to and from local standard and daylight time. 


If the argument begins with +, the output of date is under the control of the user. The format for the 
output is similar to that of the first argument to printf(S). All output fields are of fixed size (zero 
padded if necessary). Each field descriptor is preceded by a percent sign (%) and will be replaced in 
the output by its corresponding value. A single percent sign is encoded by doubling the percent sign, 
i.e., by specifying “%%”. All other characters are copied to the output without change. The string is al- 
ways terminated with a newline character. 


Field Descriptors: 

n Inserts a newline character 

t Inserts a tab character 

m Month of year — 01 to 12 

d Day of month — 01 to 31 

Last 2 digits of year — 00 to 99 
Date as mm/dd/yy 

Hour — 00 to 23 

Minute — 00 to 59 


Second — 00 to 59 


Ss = a (eS 


Time as HH:MM:SS 

j Julian date — 001 to 366 

w Day of the week — Sunday = 0 

a Abbreviated weekday — Sun to Sat 


h Abbreviated month — Jan to Dec 
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r Time in AM/PM notation 


Example 
If the current time and date was 14:45:05 on Thursday, August 1, 1976, the line 
date '+DATE: %m/%d/%y%nTIME: %H:%M:%S' 
generates as output: 


DATE: 08/01/76 
TIME: 14:45:05 


Diagnostics 
no permission You aren’t the super-user and you are trying to change the date. 
bad conversion The date set is syntactically incorrect. 


bad format character The field descriptor is not recognizable. 


Notes 


Although date may be executed at anytime, do so only when absolutely necessary. Do not change the 
date and time back and forth. Instead, shut down the system and answer the initial date and time 
prompts during boot. 
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dc — Invokes an arbitrary precision calculator. 


Syntax 


dc [ file | 


Description 


Dc is an arbitrary precision arithmetic package. Ordinarily it operates on decimal integers, but you may 
specify an input base, output base, and a number of fractional digits to be maintained. The overall 
structure of dc is a stacking (reverse Polish) calculator. If an argument is given, input is taken from 
that file until its end, then from the standard input. The following constructions are recognized: 


number 


The value of the number is pushed on the stack. A number is an unbroken string of the digits 
0—9. It may be preceded by an underscore (_) to input a negative number. Numbers may con- 
tain decimal points. 


Hage a 


The top two values on the stack are added (+), subtracted (—), multiplied (*), divided (/), 
remaindered (%), or exponentiated (*). The two entries are popped off the stack; the result is 
pushed on the stack in their place. Any fractional part of an exponent is ignored. 


SX The top of the stack is popped and stored into a register named x, where x may be any 
character. If the s is capitalized, x is treated as a stack and the value is pushed on it, 

Ix The value in register x is pushed on the stack. The register x is not altered. All registers start 
with zero value. If the | is capitalized, register x is treated as a stack and its top value is popped 
onto the main stack. 

d The top value on the stack is duplicated. 

p The top value on the stack is printed. The top value remains unchanged. p interprets the top of 
the stack as an ASCII string, removes it, and prints it. 

f All values on the stack are printed. 

q Exits the program. If executing a string, the recursion level is popped by two. If q is capitalized, 
the top value on the stack is popped and the string execution level is popped by that value. 

x Treats the top element of the stack as a character string and executes it as a string of dc com- 
mands. 

X Replaces the number on the top of the stack with its scale factor. 

[...] Puts the bracketed ASCII string onto the top of the stack. 

SX ra OX 
The top two elements of the stack are popped and compared. Register x is evaluated if they obey 
the stated relation. 

V Replaces the top element on the stack by its square root. Any existing fractional part of the ar- 


gument is taken into account, but otherwise the scale factor is ignored. 
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Interprets the rest of the line as a XENIX command. 


c All values on the stack are popped. 

i The top value on the stack is popped and used as the number radix for further input. 

I Pushes the input base on the top of the stack. 

0 The top value on the stack is popped and used as the number radix for further output. 

O Pushes the output base on the top of the stack. 

k The top of the stack is popped, and that value is used as a nonnegative scale factor; the ap- 
propriate number of places are printed on output, and maintained during multiplication, division, 
and exponentiation. The interaction of scale factor, input base, and Output base will be 
reasonable if all are changed together. 

z The stack level is pushed onto the stack. 


Z Replaces the number on the top of the stack with its length. 


? A line of input is taken from the input source (usually the terminal) and executed. 
4 Used by bc for array operations. 
Example 


This example prints the first ten values of n!: 


[lal+dsa*plal0>y]sy 


Osal 
lyx 
See Also 


be(C) 


Diagnostics 


x is unimplemented 


stack empty 

Out of space 

Out of headers 
Out of pushdown 


Nesting Depth 


Notes 


The octal number x corresponds to a character that is not implemented as a 
command 


Not enough elements on the stack to do what was asked 
The free list is exhausted (too many digits) 

Too many numbers being kept around 

Too many items on the stack 


Too many levels of nested execution 


Bc is a preprocessor for dc, providing infix notation and a C-like syntax which implements functions and 
reasonable control structures for programs. For interactive use, bc is preferred to dc . 


June 28, 1985 


Page 2 


DD (C) 


Name 
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dd — Converts and copies a file. 


Syntax 


dd [option=value] ... 


Description 


Dd copies the specified input file to the specified output with possible conversions. The standard input 
and output are used by default. The input and output block size may be specified to take advantage of 
raw physical I/O. 


Option 
if=file 
of=file 
ibs=n 
obs=n 


bs=n 


cbs=n 
skip=n 
seek=n 
count=n 
conv=ascil 
conv=ebcdic 
conv=ibm 
conv=lIcase 
conv=ucase 
conv=swab 


conv=sync 


CONV="... 5 os 


Value 

Input filename; standard input is default 
Output filename; standard output is default 
Input block size n bytes (default is block size) 
Output block size (default is block size) 


Sets both input and output block size, superseding ibs and obs; also, if no conversion is 
specified, it is particularly efficient since no in-core copy needs to be done 


Conversion buffer size 

Skips n input records before starting copy 
Seeks n records from beginning of output file before copying 
Copies only n input records 

Converts EBCDIC to ASCII 

Converts ASCII to EBCDIC 

Slightly different map of ASCII to EBCDIC 
Maps alphabetics to lowercase Option Value 
Maps alphabetics to uppercase 

Swaps every pair of bytes 

Pads every input record to ibs 


Several comma-separated conversions 


Where sizes are specified, a number of bytes is expected. A number may end with k, b, or w to specify 
multiplication by 1024, 512, or 2 respectively; a pair of numbers may be separated by x to indicate a 


product. 


Cbs is used only if ascii or ebcdic conversion is specified. In the former case cbs characters are placed 
into the conversion buffer, converted to ASCII, and trailing blanks trimmed and newline added before 
sending the line to the output. In the latter case ASCII characters are read into the conversion buffer, 


June 28, 1985 


Page 1 


DD (C) DD (C) 


converted to EBCDIC, and blanks added to make up an output record of size cbs. 


After completion, dd reports the number of whole and partial input and output blocks. 


Examples 


This command reads an EBCDIC tape, blocked ten 80-byte EBCDIC card images per record, into the 
ASCII file outfile : 


dd if=/dev/rmtO of=outfile ibs=800 cbs=80 conv=ascii,lcase 
Note the use of raw magtape. Dd is especially suited to I/O on raw physical devices because it allows 
reading and writing in arbitrary record sizes. 
See Also 


copy(C), cp(C), tar(C) 


Diagnostics 


Jt+p records in(out) Numbers of full and partial records read(written) 


Notes 


The ASCII/EBCDIC conversion tables are taken from the 256-character standard in the CACM Nov, 
1968. The ibm conversion corresponds better to certain IBM print train conventions. There is no 
universal solution. 


Newlines are inserted only on conversion to ASCII; padding is done only on conversion to EBCDIC. 
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Name 


devnm — Identifies device name. 


Syntax 


/etc/devnm [| names | 


Description 


Devnm identifies the special file associated with the mounted file system where the argument name re- 
sides. 


This command is most commonly used by /etc/re to construct a mount table entry for the root device. 


Examples 
Be sure to type full pathnames in this example: 
/etc/devnm /usr 
If /dev/hd1 is mounted on /usr, this produces: 


hd1 /usr 


Files 
/dev/* Device names 


/etc/rc Xenix startup commands 


See Also 


setmnt(C) 
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Name 


df — Reports the number of free disk blocks. 


Syntax 


af | =€] [=f 3 [ tlesystem:.... | 


Description 


Df prints out the number of free (512 byte) blocks and free inodes available for on-line file systems by 
examining the counts kept in the super-blocks. One or more filesystem arguments may be specified by 
device name (for example, /dev/hdO or /dev/usr). If the filesystem argument is unspecified, then the 
free space on all mounted file systems is sent to the standard output. The list of mounted file systems is 
given in /etc/mnttab. 


The —t flag causes the total allocated block figures to be reported as well. 
If the —f flag is given, only an actual count of the blocks in the free list is made (free inodes are not 
reported). With this option, df reports on raw devices. 
Files 
/dev/* 


/etc/mnttab 


See Also 
fsck(C), fs(F), mnttab(F) 
Notes under mount(C). 
Notes 


This utility reports sizes in 512 byte blocks. On systems which use 1024 byte blocks, this means a file of 
500 bytes uses 2 blocks. df will report 2 blocks less free space, rather than 1 block, since the file uses 
one system block of 1024 bytes. Refer to the machine(M) manual page for the block size used by your 
system. 
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Name 


diff — Compares two text files. 


Syntax 


diff [| —efbh | filel file2 


Description 


Diff tells what lines must be changed in two files to bring them into agreement. If file] (file2) is —, the 
standard input is used. If file] (file2) is a directory, then a file in that directory with the name /file2 
(filel) is used. The normal output contains lines of these forms: 


nl a n3,n4 
nl,n2 d n3 
nl1,n2 ¢ n3,n4 


These lines resemble ed commands to convert filel into file2. The numbers after the letters pertain to 
file2. In fact, by exchanging a for d and reading backward one may ascertain equally how to convert 
file2 into filel. As in ed, identical pairs where nl = n2 or n3 = n4 are abbreviated as a single number. 


Following each of these lines come all the lines that are affected in the first file flagged by <, then all 
the lines that are affected in the second file flagged by >. 


The —b option causes trailing blanks (spaces and tabs) to be ignored and other strings of blanks to com- 
pare equal. 


The —e option produces a script of a, c and d commands for the editor ed, which will recreate file2 from 
filel. The —f option produces a similar script, not useful with ed, in the opposite order. In connection 
with —e, the following shell procedure helps maintain multiple versions of a file: 


(shift; cat $#; echo '1,$p') |ed — $1 


This works by performing a set of editing operations on an original ancestral file. This is done by com- 
bining the sequence of ed scripts given as all command line arguments except the first. These scripts are 
presumed to have been created with diff in the order given on the command line. The set of editing 
operations is then piped as an editing script to ed where all editing operations are performed on the 
ancestral file given as the first argument on the command line. The final version of the file is then 
printed on the standard output. Only an ancestral file ($1) and a chain of version-to-version ed scripts 
($2,$3,...) made by diff need be on hand. 


Except in rare circumstances, diff finds the smallest sufficient set of file differences. 


The —h option does a fast, less-rigorous job. It works only when changed stretches are short and well 
separated, but also works on files of unlimited length. The —e and —f cannot be used with the —h op- 
tion. 


Files 


/usr/lib/diffh for —h 
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See Also 


cmp(C), comm(C), ed(C) 


Diagnostics 


Exit status is 0 for no differences, 1 for some differences, 2 for errors. 


Notes 


Editing scripts produced under the —e or —f option do not always work correctly on lines consisting of a 
single period (.). 
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Name 


diff3 — Compares three files. 


Syntax 


diff3 | —ex3 | filel file2 file3 


Description 


Diff3 compares three versions of a file, and publishes disagreeing ranges of text flagged with these 
codes: 


a All three files differ 


====| Filel is different 
====7) File2 is different 
====? File3 is different 


The type of change suffered in converting a given range of a given file to some other range is indicated 
in one of these ways: 


frvl a Text is to be appended after line number n/ in file f, where f = 1, 2, or 3. 


Jin y72e Text is to be changed in the range line n/ to line n2. If nl] = n2, the range may 
be abbreviated to n/. 


The original contents of the range follows immediately after a ¢ indication. When the contents of two 
files are identical, the contents of the lower-numbered file is suppressed. 


Under the —e option, diff3 publishes a script for the editor ed that will incorporate into file] all changes 


between file2 and file3, i.e., the changes that normally would be flagged ==== and ====3. The —x 
option produces a script to incorporate changes flagged with “====” Similarly, the —3 option pro- 
duces a script to incorporate changes flagged with “====3”. The following command applies a resul- 


ting editing script to filel: 


(cat script; echo '1,$p’) |ed — filel 


Files 
/tmp/d3* 


/usr /lib/diff3prog 


See Also 


diff(C) 


Notes 
The —e option does not work properly for lines consisting of a single period. 


The input file size limit is 64K bytes. 
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Name 


dircmp — Compares directories. 


Syntax 


dircmp [—d] [—s] dirl dir2 


Description 


Dircmp examines dirl and dir2 and generates tabulated information about the contents of the direc- 
tories. Listings of files that are unique to each directory are generated in addition to a list that indicates 
whether the files common to both directories have the same contents. 


There are two options available: 
—d Performs a full diff on each pair of like-named files if the contents of the files are not identical 


—s Reports whether files are “same” or “different” 


See Also 


cmp(C), diff(C) 
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Name 


dirname — Delivers directory part of pathname. 


Syntax 


dirname string 


Description 


Dirname delivers all but the last component of the pathname in string and prints the result on the stan- 
dard output. If there is only one component in the pathname, only a “dot” is printed. It is normally 
used inside substitution marks (**) within shell procedures. 


The companion command basename deletes any prefix ending in a slash (/) and the suffix (if present in 
string) from string, and prints the result on the standard output. 
Examples 
The following example sets the shell variable NAME to /usr/src/cmd: 
NAME=*“dirname /usr/src/cmd/cat.c* 
This example prints /a/b/e on the standard output: 
dirname /a/b/c/d 
This example prints a “dot” on the standard output: 


dirname file.ext 


See Also 


basename(C), sh(C) 
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Name 


disable — Turns off terminals. 


Syntax 


disable [ —d ] [ [ —e ] tty ... 


Description 


This program manipulates the /etc/ttys file and signals init to disallow logins on a particular terminal. 
The —d and —e options “disable” and “enable” terminals, respectively. 


Examples 


A simple example follows: 


disable tty01 


Multiple terminals can be disabled or enabled using the —d and —e switches before the appropriate ter- 
minal name: 


disable tty0O1 —e tty02 —d tty03 tty04 
Files 
/dev/tty* 
/etc/ttys 
See Also 


login(M), enable(C), ttys(M), getty(M), init(M) 


Warning 


Be absolutely certain to pause at least one minute before reusing this command or before using the 
enable command. Failure to do so may cause the system to crash. 
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Name 


f ) du — Summarizes disk usage. 


Syntax 


du | —afrsu | [ names | 


Description 


Du gives the number of blocks contained in all files and (recursively) directories within each directory 
and file specified by the names argument. The block count includes the indirect blocks of the file. If 
names is missing, the current directory is used. 


The optional argument —s causes only the grand total (for each of the specified names) to be given. 
The optional argument —a causes an entry to be generated for each file. Absence of either causes an 
entry to be generated for each directory only. 


The —f option causes du to display the usage of files in the current file system only. Directories contai- 
ning mounted file systems will be ignored. The —u option causes du to ignore files that have more than 
one link. 


Du is normally silent about directories that cannot be read, files that cannot be opened, etc. The —r op- 
tion will cause du to generate messages in such instances. 


A file with two or more links is only counted once. 


& Notes 


If the —a option is not used, nondirectories given as arguments are not listed. 
If there are too many distinct linked files, du will count the excess files more than once. 
Files with holes in them will get an incorrect block count. 


This utility reports sizes in 512 byte blocks. On systems which use 1024 byte blocks, this means a file of 
500 bytes is reported to be 2 blocks by du since the file uses one system block of 1024 bytes. Refer to 
the machine(M) manual page for the block size used by your system. 
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Name 


dumpdir — Prints the names of files on a backup archive. 


Syntax 


dumpdir | f filename | 


Description 


Dumpdir is used to list the names and inode numbers of all files and directories on an archive written 
with the backup command. This is most useful when attempting to determine the location of a parti- 
cular file in a set of backup archives. 


The f option causes filename to be used as the name of the backup device instead of the default. The 
backup device depends on the setting of the variable TAPE in the file /etc/default /dumpdir. 


Files 


rst* Temporary files 


See Also 


backup(C), restore(C), default(M) 
Diagnostics 


If the backup extends over more than one volume (where a volume is likely a floppy disk or tape), you 
will be asked to change volumes. Press RETURN after changing volumes. 
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Name 


echo — Echoes arguments. 


Syntax 


sche fn fl Se faa] PST aie. 


Description 


Echo writes its arguments separated by blanks and terminated by a newline on the standard output. 
The following options are recognized: 


—n Prints line without a newline. 
—e Prints arguments on the standard error output. 


—u Uses unbuffered I/O when printing. 


Prints arg exactly so that an argument beginning with a dash (e.g., —e or —n) can be specified. 
Echo also understands C-like escape conventions. The following escape sequences need to be quoted so 
that the shell interprets them correctly: 

\b Backspace 

\c Prints line without newline; same as use of —n option 
\f Form feed 

\n Newline 

\r Carriage return 

\t Tab 

\\. Backslash 


\n The 8-bit character whose ASCII code is the 1-, 2- or 3-digit octal number n, which must start with 
a zero 


Echo is useful for producing diagnostics in command files and for sending known data into a pipe. 
See Also 

csh(C), sh(C) 
Notes 


Csh has a built-in echo utility which does not have the same functionality as /bin/echo. C-shell users 
can be assured of using /bin/echo by using the csh alias command to alias echo /bin/echo. Refer to the 
csh(C) manual page for the functionality of csh echo. 

This implementation of echo is a XENIX specific enhancement and may not be present in all UNIX im- 
plementations. 


September 7, 1984 Page 1 


ED (C) ED (C) 


Name 


ed — Invokes the text editor. 


Syntax 


ed [—] [ file ] 


Description 


Ed is the standard text editor. If the file argument is given, ed simulates an e command (see below) on 
the named file; that is to say, the file is read into ed’s buffer so that it can be edited. The optional — 
suppresses the printing of character counts by e, r, and w commands, of diagnostics from e and g com- 
mands, and of the ! prompt after a !shell command. Ed operates on a copy of the file it is editing; 
changes made to the copy have no effect on the file until a w (write) command is given. The copy of 
the text being edited resides in a temporary file called the buffer. There is only one buffer. 


Commands to ed have a simple and regular structure: zero, one, or two addresses followed by a single- 
character command, possibly followed by parameters to that command. These addresses specify one or 
more lines in the buffer. Every command that requires addresses has default addresses, so that the ad- 
dresses can very often be omitted. 


In general, only one command may appear on a line. Certain commands allow the input of text. This 
text is placed in the appropriate place in the buffer. While ed is accepting text, it is said to be in input 
mode. In this mode, no commands are recognized; all input is merely collected. Input mode is left by 
typing a period (.) alone at the beginning of a line. 


Ed supports a limited form of regular expression notation; regular expressions are used in addresses to 
specify lines and in some commands (e.g., s) to specify portions of a line that are to be substituted. A 
regular expression specifies a set of character strings. A member of this set of strings is said to be 
matched by the regular expression. The regular expressions allowed by ed are constructed as follows: 


The following one-character regular expressions match a single character: 


1.1. An ordinary character (not one of those discussed in 1.2 below) is a one-character regular expres- 
sion that matches itself. 


1.2 A backslash (\) followed by any special character is a one-character regular expression that 
matches the special character itself. The special characters are: 


a. ., *, [, and \ (dot, star, left square bracket, and backslash, respectively), which are always 
special, except when they appear within square brackets ([]; see 1.4 below). 


b. % (caret), which is special at the beginning of an entire regular expression (see 3.1 and 3.2 
below), or when it immediately follows the left of a pair of square brackets ([]) (see 1.4 
below). 


c. $ (dollar sign), which is special at the end of an entire regular expression (see 3.2 below). 


d. The character used to bound (i.e., delimit) an entire regular expression, which is special for 
that regular expression (for example, see how slash (/) is used in the g command, below.) 


1.3. A period (.) is a one-character regular expression that matches any character except newline. 


1.4 A nonempty string of characters enclosed in square brackets ([]) is a one-character regular expres- 
sion that matches any one character in that string. If, however, the first character of the string 1S 
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a caret (“), the one-character regular expression matches any character except newline and the 
remaining characters in the string. The star (*) has this special meaning only if it occurs first in 
the string. The dash (—) may be used to indicate a range of consecutive ASCII characters; for ex- 
ample, [0-9] is equivalent to [0123456789]. The dash (—) loses this special meaning if it occurs 
first (after an initial caret (~), if any) or last in the string. The right square bracket (]) does not 
terminate such a string when it is the first character within it (after an initial caret (*), if any); 
e.g., []a—f] matches either a right square bracket (]) or one of the letters “a” through “f” in- 
clusive. Dot, star, left bracket, and the backslash lose their special meaning within such a string 
of characters. 


The following rules may be used to construct regular expressions from one-character regular expressions: 


2.1 


pay 


Zin 


2.4 


Pe 


2.6 


A one-character regular expression matches whatever the one-character regular expression 
matches. 


A one-character regular expression followed by a star (*) is a regular expression that matches zero 
or more occurrences of the one-character regular expression. If there is any choice, the longest 
leftmost string that permits a match is chosen. 


A one-character regular expression followed by \{m\}, \{m,\}, or \{m,n\} is a regular expression 
that matches a range of occurrences of the one-character regular expression. The values of m and 
n must be nonnegative integers less than 255; \{m\} matches exactly m occurrences; \{m,\} 
matches at least m occurrences; \{m,n\} matches any number of occurrences between m and n, 
inclusive. Whenever a choice exists, the regular expression matches as many occurrences as pos- 
sible. 


The concatenation of regular expressions is a regular expression that matches the concatenation of 
the strings matched by each component of the regular expression. 


A regular expression enclosed between the character sequences \( and \) is a regular expression 
that matches whatever the unadorned regular expression matches. See 2.6 below for a discussion 
of why this is useful. 


The expression \n matches the same string of characters as was matched by an expression en- 
closed between \( and \) earlier in the same regular expression. Here n is a digit; the subexpres- 
sion specified is that beginning with the n-th occurrence of \( counting from the left. For example, 
the expression *\(.*\)\1$ matches a line consisting of two repeated appearances of the same string. 


Finally, an entire regular expression may be constrained to match only an initial segment or final seg- 
ment of a line (or both): 


ha 


3.2 


A caret (*) at the beginning of an entire regular expression constrains that regular expression to 
match an initial segment of a line. 


A dollar sign ($) at the end of an entire regular expression constrains that regular expression to 
match a final segment of a line. The construction “entire regular expression$ constrains the en- 
tire regular expression to match the entire line. 


The null regular expression (e.g., //) is equivalent to the last regular expression encountered. 


To understand addressing in ed it is necessary to know that there is a current line at all times. Generally 
speaking, the current line is the last line affected by a command; the exact effect on the current line is 
discussed under the description of each command. Addresses are constructed as follows: 


1. 


The character . addresses the current line. 
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2. The character $ addresses the last line of the buffer. 
3. A decimal number n addresses the n-th line of the buffer. 


4. 'x addresses the line marked with the mark name character x, which must be a lowercase letter. 
Lines are marked with the k command described below. 


5. A regular expression enclosed by slashes (/) addresses the first line found by searching forward 
from the line following the current line toward the end of the buffer and stopping at the first line 
containing a string matching the regular expression. If necessary, the search wraps around to the 
beginning of the buffer and continues up to and including the current line, so that the entire buffer 
is searched. 


6. A regular expression enclosed in question marks (?) addresses the first line found by searching 
backward from the line preceding the current line toward the beginning of the buffer and stopping 
at the first line containing a string matching the regular expression. If necessary, the search wraps 
around to the end of the buffer and continues up to and including the current line. See also the 
last paragraph before Files below. 


7. An address followed by a plus sign (+) or a minus sign (—) followed by a decimal number 
specifies that address plus or minus the indicated number of lines. The plus sign may be omitted. 


8. If an address begins with + or —, the addition or subtraction is taken with respect to the current 
line; e.g, —5 is understood to mean .—S. 


9. If an address ends with + or —, then 1 is added to or subtracted from the address, respectively. 
As a consequence of this rule and of rule 8 immediately above, the address — refers to the line 
preceding the current line. (To maintain compatibility with earlier versions of the editor, the 
character * in addresses is entirely equivalent to —.) Moreover, trailing + and — characters have a 
cumulative effect, so —— refers to the current line less 2. 


10. For convenience, a comma (,) stands for the address pair 1,$, while a semicolon (;) stands for the 
pair .,9. 


Commands may require zero, one, or two addresses. Commands that require no addresses regard the 
presence of an address as an error. Commands that accept one or two addresses assume default ad- 
dresses when an insufficient number of addresses is given; if more addresses are given than such a com- 
mand requires, the last address(es) are used. 


Typically, addresses are separated from each other by a comma (,). They may also be separated by a 
semicolon (;). In the latter case, the current line (.) is set to the first address, and only then is the se- 
cond address calculated. This feature can be used to determine the starting line for forward and 
backward searches (see rules 5 and 6 above). The second address of any two-address sequence must 
correspond to a line that follows, in the buffer, the line corresponding to the first address. 


In the following list of ed commands, the default addresses are shown in parentheses. The parentheses 
are not part of the address; they show that the given addresses are the default. 


It is generally illegal for more than one command to appear on a line. However, any command (except 
e, f, r, or w) may be suffixed by p or by I, in which case the current line is either printed or listed, 


b) 


respectively, as discussed below under the p and / commands. 
(.)a 
text 


The append command reads the given text and appends it after the addressed line; dot is left at the 
last inserted line, or, if there were no inserted lines, at the addressed line. Address 0 is legal for this 
command: it causes the “appended” text to be placed at the beginning of the buffer. 
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(.)e 
<text> 


The change command deletes the addressed lines, then accepts input text that replaces these lines; 
dot is left at the last line input, or, if there were none, at the first line that was not deleted. 


(.,.)d 
The delete command deletes the addressed lines from the buffer. The line after the last line deleted 
becomes the current line; if the lines deleted were originally at the end of the buffer, the new last 
line becomes the current line. 


e file 
The edit command causes the entire contents of the buffer to be deleted, and then the named file to 
be read in; dot is set to the last line of the buffer. If no filename is given, the currently remembered 
filename, if any, is used (see the f command). The number of characters read is typed; file is 
remembered for possible use as a default filename in subsequent e, r, and w commands. If file be- 
gins with an exclamation (!), the rest of the line is taken to be a shell command. The output of this 
command is read for the e and r commands. For the w command, the file is used as the standard 
input for the specified command. Such a shell command is not remembered as the current filename. 


E file 
The Edit command is like e, except the editor does not check to see if any changes have been made 
to the buffer since the last w command. 


f file 
If file is given, the filename command changes the currently remembered filename to file; oth- 
erwise, it prints the currently remembered filename. 


(1,$)g/regular-expression/command list 

In the global command, the first step is to mark every line that matches the given regular expres- 
sion. Then, for every such line, the given command list is executed with . initially set to that line. 
A single command or the first of a list of commands appears on the same line as the global com- 
mand. All lines of a multiline list except the last line must be ended with a \; a, i, and c commands 
and associated input are permitted; the . terminating input mode may be omitted if it would be the 
last line of the command list. An empty command list is equivalent to the p command. The g, G, 
v, and V commands are not permitted in the command list. See also Notes and the last paragraph 
before Files below. 


(1,$)G/regular-expression/ 

In the interactive Global command, the first step is to mark every line that matches the given re- 
gular expression. Then, for every such line, that line is printed, dot (.) is changed to that line, and 
any one command (other than one of the a, c, i, g, G, v, and V commands) may be input and is ex- 
ecuted. After the execution of that command, the next marked line is printed, and so on; a newline 
acts as a null command; an ampersand (&) causes the re-execution of the most recent command ex- 
ecuted within the current invocation of G. Note that the commands input as part of the execution 
of the G command may address and affect any lines in the buffer. The G command can be ter- 
minated by typing an INTERRUPT. 


The help command gives a short error message that explains the reason for the most recent ? diag- 
nostic. 


The Help command causes ed to enter a mode in which error messages are printed for all subse- 
quent ? diagnostics. It will also explain the previous diagnostic if there was one. The H command 
alternately turns this mode on and off; it is initially on. 
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(.)i 


<text> 


The insert command inserts the given text before the addressed line; dot is left at the last inserted 
line, or if there were no inserted lines, at the addressed line. This command differs from the a com- 
mand only in the placement of the input text. Address 0 is not legal for this command. 


iocr Li 
The join command joins contiguous lines by removing the appropriate newline characters. If only 
one address is given, this command does nothing. 


(.)kx 
The mark command marks the addressed line with name x, which must be a lowercase letter. The 
address 'x then addresses this line; dot is unchanged. 


torah 
The /Jist command prints the addressed lines in an unambiguous way: a few nonprinting characters 
(e.g., tab, backspace) are represented by mnemonic overstrikes, all other nonprinting characters are 
printed in octal, and long lines are folded. An / command may be appended to any command other 
than e, f, r, or w. 


(.,.)ma 
The move command repositions the addressed line(s) after the line addressed by a. Address 0 is 
legal for a and causes the addressed line(s) to be moved to the beginning of the file; it is an error if 
address a falls within the range of moved lines; dot is left at the last line moved. 


(.5.)n 
The number command prints the addressed lines, preceding each line by its line number and a tab 
character; dot is left at the last line printed. The n command may be appended to any command 
other than e, f, r, or w. 


(.5+)p 
The print command prints the addressed lines; dot is left at the last line printed. The p command 
may be appended to any command other than e, f, r, or w; for example, dp deletes the current line 


and prints the new current line. 


P 
The editor will prompt with a * for all subsequent commands. The P command alternately turns 
this mode on and off; it is initially on. 

q 
The quit command causes ed to exit. No automatic write of a file is done. 

Q 
The editor exits without checking if changes have been made in the buffer since the last w com- 
mand. 

($)r file 


The read command reads in the given file after the addressed line. If no filename is given, the 
currently remembered filename, if any, is used (see e and f commands). The currently remembered 
filename is not changed unless file is the very first filename mentioned since ed was invoked. Ad- 
dress 0 is legal for r and causes the file to be read at the beginning of the buffer. If the read is suc- 
cessful, the number of characters read is typed; dot is set to the last line read in. If file begins with 
! the rest of the line is taken to be a shell (sh(C)) command whose output is to be read. Such a 
shell command is not remembered as the current filename. 
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(.,.)s/regular-expression [replacement / 
or 

(.,.)s/regular-expression /replacement /g 
The substitute command searches each addressed line for an occurrence of the specified regular ex- 
pression. In each line in which a match is found, all (nonoverlapped) matched strings are replaced 
by the replacement if the global replacement indicator g appears after the command. If the global 
indicator does not appear, only the first occurrence of the matched string is replaced. It is an error 
for the substitution to fail on all addressed lines. Any character other than space or newline may be 
used instead of / to delimit the regular expression and the replacement; dot is left at the last line on 
which a substitution occurred. 


An ampersand (& ) appearing in the replacement is replaced by the string matching the regular ex- 
pression on the current line. The special meaning of the ampersand in this context may be 
suppressed by preceding it with a backslash. The characters \n, where n is a digit, are replaced by 
the text matched by the n-th regular subexpression of the specified regular expression enclosed 
between \( and \). When nested parenthesized subexpressions are present, n is determined by coun- 
ting occurrences of \( starting from the left. When the character % is the only character in the re- 
placement, the replacement used in the most recent substitute command is used as the replacement 
in the current substitute command. The % loses its special meaning when it is in a replacement 
string of more than one character or is preceded by a \. 


A line may be split by substituting a newline character into it. The newline in the replacement 
must be escaped by preceding it with a \. Such a substitution cannot be done as part of a g or v 
command list. 


(syeptdl 
This command acts just like the m command, except that a copy of the addressed lines is placed 
after address a (which may be 0); dot is left at the last line of the copy. 


The undo command nullifies the effect of the most recent command that modified anything in the 
buffer, namely the most recent a, c, d, g, i, j, m, r, s, t, v, G, or V command. 


(1,$)v/regular-expression/command list 
This command is the same as the global command g except that the command list is executed with 
dot initially set to every line that does not match the regular expression. 


(1,$)V/regular-expression / 
This command is the same as the interactive global command G except that the lines that are 
marked during the first step are those that do not match the regular expression. 


(1,$)w file 

The write command writes the addressed lines into the named file. If the file does not exist, it is 
created with mode 666 (readable and writeable by everyone), unless the umask setting (see sh(C)) 
dictates otherwise. The currently remembered filename is not changed unless file is the very first 
filename mentioned since ed was invoked. If no filename is given, the currently remembered 
filename, if any, is used (see e and f commands); dot is unchanged. If the command is successful, 
the number of characters written is displayed. If file begins with an exclamation (!), the rest of the 
line is taken to be a shell command to which the addressed lines are supplied as the standard input. 
Such a shell command is not remembered as the current filename. 


($)= 


The line number of the addressed line is typed; dot is unchanged by this command. 
Ishell command 


The remainder of the line after the ! is sent to the XENIX shell (sh(C)) to be interpreted as a com- 
mand. Within the text of that command, the unescaped character % is replaced with the 
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remembered filename; if a ! appears as the first character of the shell command, it is replaced with 
the text of the previous shell command. Thus, !! will repeat the last shell command. If any expan- 
sion is performed, the expanded line is echoed; dot is unchanged. 


(.+1) An address alone on a line causes the addressed line to be printed. A RETURN alone on a line is 
equivalent to .+1p. This is useful for stepping forward through the editing buffer a line at a time. 


If an interrupt signal (ASCII DEL or BREAK) is sent, ed prints a question mark (?) and returns to its 
command level. 


Some size limitations: 512 characters per line, 256 characters per global command list, 64 characters per 
filename, and 128K characters in the buffer. The limit on the number of lines depends on the amount of 
user memory. 


When reading a file, ed discards ASCII NUL characters and all characters after the last newline. Files 
that contain characters not in the ASCII set (bit 8 on) cannot be edited by ed. 


If the closing delimiter of a regular expression or of a replacement string (e.g., /) would be the last 
character before a newline, that delimiter may be omitted, in which case the addressed line is printed. 
Thus the following pairs of commands are equivalent: 


s/s1/s2s/s1/s2/p 
g/slg/sl/p 
2519s1? 

Files 


/tmp/e# Temporary; # is the process number 


ed. hup Work is saved here if the terminal is hung up 


See Also 


grep(C), sed(C), sh(C) 


Diagnostics 


” Command errors 
? file An inaccessible file 


Use the help and Help commands for detailed explanations. 


If changes have been made in the buffer since the last w command that wrote the entire buffer, ed 
warns the user if an attempt is made to destroy ed’s buffer via the e or gq commands: it prints ? and al- 
lows you to continue editing. A second e or q command at this point will take effect. The dash (—) 
command-line option inhibits this feature. 

Notes 


An exclamation (!) command cannot be subject to a g or a v command. 


The ! command and the ! escape from the e, r, and w commands cannot be used if the the editor is in- 
voked from a restricted shell (see sh(C)). 


The sequence \n in a regular expression does not match any character. 
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The / command mishandles DEL. 


Because 0 is an illegal address for the w command, it is not possible to create an empty file with ed. 
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Name 


enable — Turns on terminals. 


Syntax 


enable [—d | [ [ —e ] tty ... 


Description 


This program manipulates the /etc/ttys file and signals init to allow logins on a particular terminal. 
The —e and —d options may be used to allow logins on some terminals and disallow logins on other ter- 
minals in a single command. 

Examples 
A simple command to enable tty01 follows: 


enable tty01 


Multiple terminals can be disabled or enabled using the —d and —e switches before the appropriate ter- 
minal name: 


enable tty01 —e tty02 —d tty03 tty04 
Files 
/dev/tty* 


/etc/ttys 


See Also 


login(M), disable(C), ttys(M), getty(M), init(M) 
Warning 


Be absolutely certain to pause at least one minute before reusing this command or before using the 
disable command. Failure to do so may cause the system to crash. 
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Name 


env — Sets environment for command execution. 


Syntax 


env [—] [ name=value ] ... [ command args | 


Description 


Env obtains the current environment, modifies it according to its arguments, then executes the command 
with the modified environment. Arguments of the form name=value are merged into the inherited en- 
vironment before the command is executed. The — flag causes the inherited environment to be ignored 
completely, so that the command is executed with exactly the environment specified by the arguments. 


If no command is specified, the resulting environment is printed, one name-value pair per line. 


See Also 


sh(C), exec(S), profile(F), environ(M) 


Notes 


The 2.3 printenv command has been replaced in XENIX 3.0 by the env command. The printenv shipped 
is simply a link to the 3.0 command env. 
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Name 


ex — Invokes a text editor. 


Syntax 


ex [—][-—v][-—t tag ] [—r] [ tlineno | name... 


Description 


For 


Ex is the root of the editors ex and vi. Ex is a superset of ed, whose most notable extension is a display 
editing facility. Display based editing is the focus of vi. 


If you have not used ed, or if you are a casual user, you will find that edit is most convenient for you. It 
avoids some of the complexities of ex which is used mostly by systems programmers and persons very 
familiar with ed. 


If you have a CRT terminal, you may wish to use a display based editor; in this case see vi(C), a com- 
mand which focuses on the display editing portion of ex. 


ed Users 


If you have used ed you will find that ex has a number of new features. Intelligent terminals and high- 
speed terminals are very pleasant to use with wi. Generally, the ex editor uses far more of the capabili- 
ties of terminals than ed does. It uses the terminal capability database termcap (M) and the type of the 
terminal you are using from the variable TERM in the environment to determine how to drive your ter- 
minal efficiently. The ex editor makes use of features such as insert and delete character and line in its 
visual command mode, which can be abbreviated vi , and which is the central mode of editing when 
using vi(C). There is also an interline editing open command, (0) that works on all terminals. 


Ex contains a number of features for easily viewing the text of a file. The z command gives easy access 
to windows of text. Hitting CNTRL-D causes the editor to scroll a half-window of text and is more 
useful for quickly stepping through a file than just hitting the RETURN key. Of course, the screen- 
oriented visual mode gives constant access to editing context. 


Ex gives you more help when you make mistakes. The undo (u) command allows you to reverse any 
single change. Ex gives you a lot of feedback, normally printing changed lines, and indicates when more 
than a few lines are affected by a command so it is easy to detect when a command has affected more 
lines than it should have. 


The editor also normally prevents the overwriting of existing files unless you have edited them, so that 
you don’t accidentally clobber with a write a file other than the one you are editing. If the system (or 
editor) crashes, or you accidentally hang up the phone, you can use the recover command to retrieve 
your work. This will get you back to within a few lines of where you left off. 


Ex has several features for editing more than one file at a time. You can give it a list of files on the 
command line and use the next (n) command to edit each in turn. You can also give the next command 
a list of filenames, or a pattern used by the shell to specify a new set of files to be edited. In general, 
filenames in the editor may be formed with full shell metasyntax. The metacharacter “%”’ is also 
available in forming filenames and is replaced by the name of the current file. For editing large groups 
of related files you can use ex’s tag command to quickly locate functions and other important points in 
any of the files. This is useful when you want to find the definition of a particular function in a large 
program. The command ctags(CP) builds a tags file or a group of C programs. 
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For moving text between files and within a file, the editor has a group of buffers named a through z. 
You can place text in these named buffers and carry it over when you edit another file. 


The command & repeats the last substitute command. There is also a confirmed substitute command. 
You give a range of substitutions to be done and the editor interactively asks whether each substitution 
is desired. 


You can use the substitute command in ex to systematically convert the case of letters between upper- 
case and lowercase. It is possible to ignore case in searches and substitutions. Ex also allows regular 
expressions that match words to be constructed. This is convenient, for example, when searching for the 
word “edit” if your document also contains the word “editor.” 


Ex has a set of options that you can set. One option which is very useful is the autoindent option that 
allows the editor to automatically supply leading white space to align text. You can then use the 
CNTRL-D key to backtab, space and tab forward to align new code easily. 


Miscellaneous new useful features include an intelligent join (j) command which supplies whitespace 
between joined lines automatically, the commands < and > which shift groups of lines, and the ability 
to filter portions of the buffer through commands such as sort. 


Files 
/usr/lib/ex2.Ostrings Error messages 
/usr/lib/ex2.0recover Recover command 
/usr/lib/ex2.0preserve Preserve command 
/etc/termcap Describes capabilities of terminals 
$HOME/.exre Editor startup file 
/tmp/Exnannnn Editor temporary 
/tmp/Rxnnnnn Named buffer temporary 
/usr/ preserve Preservation directory 

See Also 


awk(C), ctags(CP), ed(C), grep(C), sed(C), termcap(M), vi(C) 


Credit 


This utility was developed at the University of California at Berkeley and is used with permission. 


Notes 


The undo command causes all marks to be lost on lines changed and then restored if the marked lines 
were changed. 


Undo never clears the buffer modified condition. 


The z command prints a number of logical rather than physical lines. More than a screen full of output 
may result if long lines are present. 
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File input/output errors don’t print a name if the command line “—” option is used. 
There is no easy way to do a single scan ignoring case. 


Because of the implementation of the arguments to next, only 512 bytes of argument list are allowed 
there. 


The format of /etc/termcap and the large number of capabilities of terminals used by the editor cause 
terminal type setup to be rather slow. 


The editor does not warn if text is placed in named buffers and not used before exiting the editor. 


Null characters are discarded in input files and cannot appear in resultant files. 
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Name 


expr — Evaluates arguments as an expression. 


Syntax 


expr arguments 


Description 


The arguments are taken as an expression. After evaluation, the result is written on the standard 
output. Terms of the expression must be separated by blanks. Characters special to the shell must be 
escaped. Note that zero is returned to indicate a zero value, rather than the null string. Strings contal- 
ning blanks or other special characters should be quoted. Integer-valued arguments may be preceded by 
a unary minus sign. Internally, integers are treated as 32-bit, 2’s complement numbers. 


The operators and keywords are listed below. Expressions should be quoted by the shell, since many of 
the characters that have special meaning in the shell also have special meaning in expr. The list is in 
order of increasing precedence, with equal precedence operators grouped within braces ({ and }). 


expr | expr 
Returns the first expr if it is neither null nor 0, otherwise returns the second expr. 


expr & expr 
Returns the first expr if neither expr is null nor 0, otherwise returns 0. 


expr { =, >, >=, <, <=, !=} expr 
Returns the result of an integer comparison if both arguments are integers, otherwise returns 
the result of a lexical comparison. 


expr { +, —} expr 
Addition or subtraction of integer-valued arguments. 


expr {*, /, % } expr 
Multiplication, division, or remainder of the integer-valued arguments. 


expr: expr 

The matching operator : compares the first argument with the second argument which must be 
a regular expression; regular expression syntax is the same as that of ed(C), except that all pat- 
terns are “anchored” (i.e., begin with a caret (*)) and therefore the caret is not a special 
character in that context. (Note that in the shell, the caret has the same meaning as the pipe 
symbol (|).) Normally the matching operator returns the number of characters matched (zero on 
failure). Alternatively, the \(...\) pattern symbols can be used to return a portion of the first ar- 
gument. 


Examples 
1. a=*‘expr $a + 1° 


Adds 1 to the shell variable a. 


2. # For $a equal to either "/usr/abc/file" or just "/file" 
‘expr $a : .*/\(.*\) | $a’ 
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Returns the last segment of a pathname (i.e., file). Watch out for the slash alone as an argu- 
ment: expr will take it as the division operator (see Notes below). 


3) “expr SVAR..2. 


Returns the number of characters in $VAR. 


See Also 


ed(C), sh(C) 


Diagnostics 


As a side effect of expression evaluation, expr returns the following exit values: 


0 If the expression is neither null nor zero 
| If the expression is null or zero 
2 For invalid expressions 


Other diagnostics include: 
syntax error For operator/operand errors 


nonnumeric argument _ If arithmetic is attempted on such a string 


Notes 


After argument processing by the shell, expr cannot tell the difference between an operator and an 
operand except by the value. If $a is an equals sign (=), the command: 


expr $a = = 
looks like: 
expr = = = 


Thus the arguments are passed to expr (and will all be taken as the = operator). The following permits 
comparing equals signs: 


expr X$a = X= 
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Name 


factor — Factor a number. 


Syntax 


factor [ number | 


Description 


When factor is invoked without an argument, it waits for a number to be typed in. If you type in a po- 
sitive number less than 2° (about 7.2x10'°) it will factor the number and print its prime factors; each 
one is printed the proper number of times. Then it waits for another number. It exits if it encounters a 
zero Or any non-numeric character. 


If factor is invoked with an argument, it factors the number as above and then exits. 
The time it takes to factor a number, 2, is proportional to n. It usually takes longer to factor a prime or 
the square of a prime, than to factor other numbers. 

Diagnostics 


Factor returns an error message if the supplied input value is greater than 2°° or is not an integer 
number. 
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Name 


false — Returns with a nonzero exit value. 


Syntax 


false 


Description 


False does nothing except return with a nonzero exit value. True(C), false’s counterpart, does nothing 
except return with a zero exit value. False is typically used in shell procedures such as: 


until false 
do 

command 
done 


See Also 


sh(C), true(C) 


Diagnostics 


False has exit status 1. 
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Name 


file — Determines file type. 


Syntax 
file [—m ] file ... 


file | —m ] —f namesfile 


Description 


File performs a series of tests on each argument in an attempt to classify it. If an argument appears to 
be ASCII, file examines the first 512 bytes and tries to guess its language. 


If the —f option is given, file takes the list of filenames from namesfile. If the —m option is given, file 
sets the access time for the examined file to the current time. Otherwise, the access time remains un- 
changed. 


Several object file formats are recognized. For a.out and x.out format object files, the relationship of cc 
flags to file classification is —i for “separate”, —n for “pure”, and —s for not “not stripped”. 


Credit 


This utility was developed at the University of California at Berkeley and is used with permission. 


c™ 


Notes 


It can make mistakes: in particular it often suggests that command files are C programs. 
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Name 


find — Finds files. 


Syntax 


FIND (C) 


find pathname-list expression 


Description 


Find recursively descends the directory hierarchy for each pathname in the pathname-list (1.e., one or 
more pathnames) seeking files that match a Boolean expression written in the primaries given below. In 
the descriptions, the argument n is used as a decimal integer where +m means more than n, —n means 
less than n, and n means exactly n. 


—name file 


—perm onum 


—type x 


—links n 


—user uname 


—group gname 


—size n 

—atime n 
—mtime n 
—ctime n 


—exec cmd 


—ok cmd 


—print 


—newer file 
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True if file matches the current filename. Normal shell argument syntax may be 
used if escaped (watch out for the left bracket ([), the question mark (?) and the star 


(*)). 


True if the file permission flags exactly match the octal number onum (see 
chmod(C)). If onum is prefixed by a minus sign, more flag bits (017777, see stat(S)) 
become significant and the flags are compared: 


(flags &onum)==onum 


True if the type of the file is x, where x is b for a block special file, ¢ for a character 
special file, d for a directory, p for a named pipe, f for a plain file, s for a semaphore, 
or m for a shared data file. 


True if the file has n links. 


True if the file belongs to the user uname. If uname is numeric and does not appear 
as a login name in the /etc/passwd file, it is taken as a user ID. 


True if the file belongs to the group gname. If gname is numeric and does not appear 
in the /etc/group file, it is taken as a group ID. 


True if the file is n blocks long (512 bytes per block). 
True if the file has been accessed in n days. 
True if the file has been modified in n days. 
True if the file has been changed in n days. 


True if the executed cmd returns a zero value as exit status. The end of cmd must be 
punctuated by an escaped semicolon. A command argument {} is replaced by the 
current pathname. 


Like —exec except that the generated command line is printed with a question mark 
first, and is executed only if the user responds by typing y. 


Always true; causes the current pathname to be printed. 


True if the current file has been modified more recently than the argument file. 
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( expression ) True if the parenthesized expression is true (parentheses are special to the shell and 
must be escaped). 
The primaries may be combined using the following operators (in order of decreasing precedence): 


negation 
The negation of a primary is specified with the exclamation (!) unary not operator. 


AND 
The AND operation is implied by the juxtaposition of two primaries. 


OR The OR operation is specified with the —o operator given between two primaries. 


Examples 
The following removes all files named a.out or +.0 that have not been accessed for a week: 


find / \( -name a.out -o -name '*.0' \) -atime +7 -exec rm {} \; 


Files 


/etc/passwd 


/etc/group 


See Also 


cpio(C), sh(C), test(C), stat(S), cpio(F) 
Notes 


Find will search no more than 17 levels of nested subdirectories. If a directory contains subdirectories at 
higher levels of nesting, find displays an error message and ignores the subdirectories. 
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Name 


finger — Finds information about users. 


Syntax 


finger [ -bfilpqsw ] [login1 [login2 ...] ] 


Description 


By default finger lists the login name, full name, terminal name and write status (as a “*” before the 
terminal name if write permission is denied), idle time, login time, and office location and phone number 
(if they are known) for each current XENIX user. (Idle time is minutes if it is a single integer, hours 
and minutes if a colon (:) is present, or days and hours if a “‘d” is present.) 


A longer format also exists and is used by finger whenever a list of names is given. (Account names as 
well as first and last names of users are accepted.) This is a multiline format; it includes all the informa- 
tion described above as well as the user’s home directory and login shell, any plan which the person has 
placed in the file .plan in their home directory, and the project on which they are working from the file 
.project also in the home directory. 


Finger options are: 

—b Briefer long output format of users. 

—f Suppresses the printing of the header line (short format) 
—i Quick list of users with idle times. 

—l1 Forces long output format. 

—p Suppresses printing of the .plan files. 

—q Quick list of users. 

—s Forces short output format. 


—w Forces narrow format list of specified users. 


Files 
/etc/utmp Who file 
/etc/passwd User names, offices, phones, login directories, and shells 
/usr/adm/lastlog Last login times 
$HOME/.plan Plans 
$HOME/.project Projects 
See Also 
who(C) 
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Credit 


This utility was developed at the University of California at Berkeley and is used with permission. 


Notes 
Only the first line of the .project file is printed. 


The “office” column of the output will contain any text in the comment field of the user’s /etc/passwd 
file entry that immediately follows a comma (,). For example, if the entry is 


johnd:eX8 HinAk:201:50:John Doe, 321:/usr/johnd:/bin/sh 
the number 321 will appear in the office column. 


Idle time is computed as the elapsed time since any activity on the given terminal. This includes pre- 
vious invocations of finger which may have modified the terminal’s corresponding device file /dev/tty??. 
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Name 


fsck — Checks and repairs file systems. 


Syntax 


/etc/fsck [ options | [ file-system ] ... 


Description 


Fsck audits and interactively repairs inconsistent conditions for XENIX file systems, whether XENIX 
version 2.3 or 3.0. If the file system is consistent then the number of files, number of blocks used, and 
number of blocks free are reported. If the file system is inconsistent the operator is prompted for con- 
currence before each correction is attempted. It should be noted that most corrective actions result in 
some loss of data. The amount and severity of the loss may be determined from the diagnostic output. 
The default action for each consistency correction is to wait for the operator to respond “‘yes”’ or “‘no”’. 
If the operator does not have write permission fsck defaults to the action of the —n option. 


The following flags are interpreted by fsck: 
—y Assumes a yes response to all questions asked by fsck. 
—n Assumes a no response to all questions asked by fsck; do not open the file system for writing. 


—sb:c Ignores the actual free list and (unconditionally) reconstructs a new one by rewriting the super- 
block of the file system. The file system must be unmounted while this is done. 


The —sb:c:c option allows for creating an optimal free-list organization. The following forms are 
supported: 


=" 
—sBlocks-per-cylinder:Blocks-to-skip (for anything else) 


If b:c is not given, then the values used when the file system was created are used. If these 
values were not specified, then a reasonable default value is used. 


—S Conditionally reconstructs the free list. This option is like —sb:c above except that the free list is 
rebuilt only if there are no discrepancies discovered in the file system. Using —S forces a “‘no” 
response to all questions asked by fsck. This option is useful for forcing free list reorganization 
on uncontaminated file systems. 


=f If fsck cannot obtain enough memory to keep its tables, it uses a scratch file. If the —t option is 
specified, the file named in the next argument is used as the scratch file, if needed. Without the 
—t flag, fsck prompts the operator for the name of the scratch file. The file chosen should not be 
on the file system being checked, and if it is not a special file or did not already exist, it is 
removed when fsck completes. 


—rr Recovers the root file system. The required filesystem argument must refer to the root file 
system, and preferably to the block device (normally /dev/root .) This switch implies —y and 
overrides —n . If any modifications to the file system are required, the system will be automati- 
cally shutdown to insure the integrity of the file system. 


—c Causes any supported file system to be converted to the type of the current file system. The user 
is asked to verify the request for each file system that requires conversion unless the —y option is 
specified. It is recommended that every file system be checked with this option, while unmounted 
if it is to be used with the current version of XENIX. To update the active root file system, it 
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should be checked with: 
fsck —c —rr /dev/root 
If no file systems are specified, fsck reads a list of default file systems from the file /etc/checklist. 


Inconsistencies checked are as follows: 


Blocks claimed by more than one inode or the free list 


Blocks claimed by an inode or the free list outside the range of the file system 


Incorrect link counts 


Size checks: 
Incorrect number of blocks 
Directory size not 16-byte aligned 


Bad inode format 


Blocks not accounted for anywhere 


Directory checks: 
File pointing to unallocated inode 
Inode number out of range 


Super-block checks: 
More than 65536 inodes 
More blocks for inodes than there are in the file system 


Bad free block list format 


Total free block or free inode count incorrect 


Orphaned files and directories (allocated but unreferenced) are, with the operator’s concurrence, recon- 
nected by placing them in the lost+found directory. The name assigned is the inode number. The only 
restriction is that the directory lost+found must preexist in the root of the file system being checked and 
must have empty slots in which entries can be made. This is accomplished by making lost+found, 
copying a number of files to the directory, and then removing them (before fsck is executed). 


Files 


/etc/checklist Contains default list of file systems to check 


See Also 


checklist(F), filesystem(F) 
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Diagnostics 


c™ 


The diagnostics produced by fsck are intended to be self-explanatory. 


Notes 


Fsck will not run on a mounted non-raw file system unless the file system is the root file system or 
unless the —n option is specified and no writing out of the file system will take place.. If any such at- 
tempt is made, a warning is printed and no further processing of the file system is done for the specified 
device. 


Although checking a raw device is almost always faster, there is no way to tell if the file system is 
mounted. And cleaning a mounted file system will almost certainly result in an inconsistent superblock. 
Warning 


For a XENIX 2.3 file system to be properly supported under XENIX 3.0, it is necessary that fsck be run 
on each 2.3 file system to be mounted under the KENIX 3.0 kernel. For the root file system, 
“fsck —rr /dev/root” should be run and for all other file systems “fsck /dev/??” on the unmounted 
block device should be used. 
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Name 


getopt — Parses command options. 


Syntax 


set —— ‘getopt optstring $*° 


Description 


Getopt is used to check and break up options in command lines for parsing by shell procedures. Optst- 
ring is a string of recognized option letters (see getopt(S)). If a letter is followed by a colon, the option 
is expected to have an argument which may or may not be separated from it by whitespace. The special 
option —— is used to delimit the end of the options. Getopt will place —— in the arguments at the end 
of the options, or recognize it if used explicitly. The shell arguments ($1 $2...) are reset so that each 
option is preceded by a dash (—) and in its own shell argument; each option argument is also in its own 
shell argument. 


Example 


The following code fragment shows how one can process the arguments for a command that can take the 
options a and b, and the option 0, which requires an argument: 


set — — ‘getopt abo: $** 

if [ $? = 0 ] 

then 

ce echo $USAGE 

exit 2 

fi 

for i in $+ 

do 
case $1 in 
—a | —b) FLAG=$i; shift;; 
—o) OARG=$2; shift; shift;; 
=) shift;  break;; 
esac 

done 


This code will accept any of the following as equivalent: 
cmd —aoarg file file 
cmd —a —o arg file file 
cmd —oarg —a file file 
cmd —a —oarg —— file file 


See Also 
sh(C), getopt(S) 
Diagnostics 
i Getopt prints an error message on the standard error when it encounters an option letter not included in 


optstring. 
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Name 


grep, egrep, fgrep — Searches a file for a pattern. 


Syntax 
grep [ options | expression [ files | 
egrep [ options | [ expression | [ files | 


fgrep [ options | [ strings | [ files | 


Description 


Commands of the grep family search the input files (standard input default) for lines matching a 
pattern. Normally, each line found is copied to the standard output. Grep patterns are limited regular 
expressions in the style of ed(C); it uses a compact nondeterministic algorithm. Egrep patterns are full 
regular expressions; it uses a fast deterministic algorithm that sometimes needs exponential space. 
Fgrep patterns are fixed strings; it is fast and compact. The following options are recognized: 


eh All lines but those matching are printed. 

—x Prints only exact matches of an entire line. (Fgrep only.) 

aa Only a count of matching lines is printed. 

| Only the names of files with matching lines are listed, separated by newlines. 
—n Each line is preceded by its relative line number in the file. 


—b Each line is preceded by the block number on which it was found. This is sometimes useful in lo- 
cating disk block numbers by context. 


—y Turns on matching of letters of either case in the input so that case is insignificant. Does not 
work for egrep. 


—h _ Prevents the name of the file containing the matching line from being appended to that line. Use 
when searching multiple files. 


—e expression 
Same as a simple expression argument, but useful when the expression begins with a dash (—). 


—f file 
The regular expression for grep or egrep, or strings list (for fgrep) is taken from the file. 


In all cases, the filename is output if there is more than one input file. Care should be taken when using 
the characters $, *, [, *, |, (, ), and \ in expression, because they are also meaningful to the shell. It is 
safest to enclose the entire expression argument in single quotation marks. 


F grep searches for lines that contain one of the strings separated by newlines. 
Egrep accepts regular expressions as in ed(C), except for \( and \), with the addition of the following: 


— A regular expression followed by a plus sign (+) matches one or more occurrences of the regular ex- 
pression. 
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— A regular expression followed by a question mark (?) matches 0 or 1 occurrences of the regular ex- 


pression. =, 


— Two regular expressions separated by a vertical bar (|) or by a newline match strings that are 
matched by either regular expression. 


— A regular expression may be enclosed in parentheses () for grouping. 
The order of precedence of operators is [], then *?+, then concatenation, then the backslash (\) and the 
newline. 

See Also 


ed(C), sed(C), sh(C) 


Diagnostics 


Exit status is 0 if any matches are found, | if none, 2 for syntax errors or inaccessible files. 


Notes 


Ideally there should be only one grep, but there isn’t a single algorithm that spans a wide enough range 
of space-time tradeoffs. 


Lines are limited to 256 characters; longer lines are truncated. 
Egrep does not recognize ranges, such as [a—z], in character classes. ( ) 


When using grep with the —y option, the search is not made totally case insensitive in character ranges 
specified within brackets. 


Multiple strings can be specified in fgrep without using a separate strings file by using the quoting con- 
ventions of the shell to imbed newlines in the single string argument. For example, you might type the 
following at the command line: 


fgrep ‘string 1 
string2 
string3’ text.file 
Similarly, multiple strings can be specified in egrep by doing: 
egrep ‘string lbtring2string3’ text.file 


Thus egrep can do almost anything that grep and frep can do. 
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Name 


grpcheck — Checks group file. 


Syntax 
pwcheck [file] 


erpcheck [file] 


Description 


Grpcheck verifies all entries in the group file. This verification includes a check of the number of fields, 
group name, group ID, and whether all login names appear in the password file. The default group file is 


/etc/group. 


Files 


/etc/group 


/etc/passwd 


See Also 


pwcheck(C), group(M), passwd(M) 


Diagnostics 


Group entries in /etc/group with no login names are flagged. 
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Name 


haltsys — Closes out the file systems and halts the CPU. 


Syntax 


/etc/haltsys 


Description 


Haltsys does a shutdn() system call (see shutdn(S)) to flush out pending disk I/O, mark the file sys- 
tems clean, and halt the processor. Haltsys takes effect immediately, so user processes should be killed 
beforehand. Shutdown(C) is recommended for normal system termination; it warns the users, cleans 
things up, and calls haltsys. Use haltsys directly only if some system problem prevents the running of 
shutdown. 


Notes 


haltsys does not lock hard disk heads. 


See Also 


shutdn(S), shutdown(C) 
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Name 


hd — Displays files in hexadecimal format. 


Syntax 


hd [ —format [ —s offset ] [ —n count ] | file ] ... 


Description 


The hd command displays the contents of files in hexadecimal, octal, decimal, and character formats. 
Control over the specification of ranges of characters is also available. The default behavior is with the 
following flags set: “—abx —A”. This says that addresses (file offsets) and bytes are printed in hexade- 
cimal and that characters are also printed. If no file argument is given, the standard input is read. 


Options include: 


—s offset Specify the beginning offset in the file where printing is to begin. If no ‘file’ argument is 
given, or if a seek fails because the input is a pipe, ‘offset’ bytes are read from the input 
and discarded. Otherwise, a seek error will terminate processing of the current file. 


The offset may be given in decimal, hexadecimal (preceded by ‘Ox’), or octal (preceded by 
a ‘0’). It is optionally followed by one of the following multipliers: w, 1, b, or k; for words 
(2 bytes), long words (4 bytes), half kilobytes (512 bytes), or kilobytes (1024 bytes). Note 
that this is the one case where “‘b” does not stand for bytes. Since specifying a hexade- 
cimal offset in blocks would result an an ambiguous trailing ‘b’, any offset and multiplier 
may be separated by an asterisk (*). 


—n count Specify the number of bytes to process. The count is in the same format as offset, above. 


Format Flags 


Format flags may specify addresses, characters, bytes, words (2 bytes) or longs (4 bytes) to be printed in 
hex, decimal, or octal. Two special formats may also be indicated: text or ascii. Format and base 
specifiers may be freely combined and repeated as desired in order to specify different bases (hexade- 
cimal, decimal or octal) for different output formats (addresses, characters, etc.). All format flags ap- 
pearing in a single argument are applied as appropriate to all other flags in that argument. 


acbwlA 
Output format specifiers for addresses, characters, bytes, words, longs and ascii respectively. Only 
one base specifier will be used for addresses; the address will appear on the first line of output that 
begins each new offset in the input. 


The character format prints printable characters unchanged, special C escapes as defined in the 
language, and the remaining values in the specified base. 


The ascii format prints all printable characters unchanged, and all others as a period (.). This 
format appears to the right of the first of other specified output formats. A base specifier has no 
meaning with the ascii format. If no other output format (other than addresses) is given, bx is as- 
sumed. If no base specifier is given, a// of xdo are used. 


hxdo 
Output base specifiers for hexadecimal, decimal and octal. If no format specifier is given, all of 


acbwl are used. 
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t Print a text file, each line preceded by the address in the file. Normally, lines should be terminated 
by a \n character; but long lines will be broken up. Control characters in the range 0x00 to Oxlf are 
printed as ““@’ to “_’. Bytes with the high bit set are preceded by a tilde (~) and printed as if the 
high bit were not set. The special charcters (“, ~, \) are preceded by a backslash (\) to escape their 
special meaning. As special cases, two values are represented numerically as ‘\177’ and ‘\377’. This 
flag will override all output format specifiers except addresses. 
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Name 


head — Prints the first few lines of a stream. 


Syntax 


head [ —count | [ file... | 


Description 


This filter prints the first count lines of each of the specified files. If no files are specified, head reads 
from the standard input. If no count is specified, then 10 lines are printed. 


See Also 


tail(C) 


Credit 


This utility was developed at the University of California at Berkeley and is used with permission. 
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Name 


id — Prints user and group IDs and names. 


Syntax 


id 


Description 


Id writes a message on the standard output giving the user and group IDs and the corresponding names 
of the invoking process. If the effective and real IDs do not match, both are printed. 


See Also 


logname(C), getuid(S) 
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Name 


join — Joins two relations. 


Syntax 


join [ options | filel file2 


Description 


Join forms, on the standard output, a join of the two relations specified by the lines of file/ and file2. 
If filel is a dash (—), the standard input is used. 


Filel and file2 must be sorted in increasing ASCII collating sequence on the fields on which they are to 
be joined, normally the first in each line. 


There is one line in the output for each pair of lines in file] and file2 that have identical join fields. 
The output line normally consists of the common field, then the rest of the line from file, then the rest 
of the line from /file2. 


Fields are normally separated by blank, tab or newline. In this case, multiple separators count as one, 
and leading separators are discarded. 


These options are recognized: 


—an In addition to the normal output, produces a line for each unpairable line in file n, where n is 
lL OP 2; 

—es Replaces empty output fields by string s. 

—jnm Joins on the mth field of file n. If n is missing, uses the mth field in each file. 

—o list Each output line comprises the fields specifed in /Jist, each element of which has the form 


n.m, where n is a file number and m is a field number. 
= Uses character c as a separator (tab character). Every appearance of c in a line is 
significant. 
See Also 


awk(C), comm(C), sort(C) 
Notes 


With default field separation, the collating sequence is that of sort —b; with —t, the sequence is that of a 
plain sort. 
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Name 


kill — Terminates a process. 


Syntax 


kill [ —signo | processid ... 


Description 


Kill sends signal 15 (terminate) to the specified processes. This will normally kill processes that do not 
catch or ignore the signal. The process number of each asynchronous process started with & is reported 
by the shell (unless more than one process is started in a pipeline, in which case the number of the last 
process in the pipeline is reported). Process numbers can also be found by using ps(C). 


For example, if process number 0 is specified, all processes in the process group are signaled. 
The killed process must belong to the current user unless he is the super-user. 
If a signal number preceded by — is given as the first argument, that signal is sent instead of the ter- 
minate signal (see signal(S)). In particular “kill —9 ...” is a sure kill. 
See Also 


ps(C), sh(C), kill(S), signal(S) 
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Name 


1 — Lists information about contents of directory. 


Syntax 


1 [| —asdrucifg | name ... 


Description 


For each directory argument, / lists the contents of the directory; for each file argument, / repeats its 
name and other requested information. The output is sorted alphabetically by default. When no argu- 
ment is given, the current directory is listed. When several arguments are given, the arguments are first 
sorted appropriately, but file arguments appear before directories and their contents. Information is 
listed in the format of the “Ils —l’? command, which is identical to the / command. This format and all 
provided switches are described in /s(C), to which should you should refer for a complete discussion of 


the capabilities of J. 


Files 
/etc/passwd Contains user IDs 


/etc/group Contains group IDs 


Notes 
Newline and tab are considered printing characters in filenames. 


The output device is assumed to be 80 columns wide. 
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Name 


lc — Lists directory contents in columns. 


Syntax 


Ic [| —1LACFRabcdfgilmnqrstux | name ... 


Description 


Lc lists the contents of files and directories, in columns. If name is a directory name, Ic lists the con- 
tents of the directory; if name is a filename, /c repeats the filename and any other information re- 
quested. Output is given in columns and sorted alphabetically. If no argument is given, the current 
directory is listed. If several arguments are given, they are sorted alphabetically, but file arguments ap- 
pear before directories. 


Files that are not the contents of a directory being interpreted are always sorted across the page rather 
than down the page in columns. A stream output format is available in which files are listed across the 
page, separated by commas. The —m option enables this format. 


The options are: 
—1 Forces an output format with one entry per line. 


—A If not the root directory, this option displays all files that begin with “.”’ (except “.” and “..” them- 
selves). Otherwise, files are displayed normally. 


—C Forces columnar output, even if redirected to a file. 


—F Causes directories to be marked with a trailing “‘/”’ and executable files to be marked with a trailing 


6699 


—R Recursively lists subdirectories. 

—a Lists all entries; usually “.” and “..’’ are suppressed. 

—b Forces printing of nongraphic characters in the \ddd notation, in octal. 
—c Sorts by time of file creation. 


—d If the argument is a directory, lists only its name, not its contents (mostly used with —I to get status 
on directory). 


—f Forces each argument to be interpreted as a directory and lists the name found in each slot. This 
option turns off —l, —t, —s, and —r, and turns on —a; the order is the order in which entries appear 
in the directory. 


—g The same as —l, except that the owner is not printed. 
—i Prints inode number in first column of the report for each file listed. 


—] Lists in long format, giving mode, number of links, owner, group, size in bytes, and time of last 
modification for each file. If the file is a special file the size field instead contains the major and 
minor device numbers. 


—o The same as —l, except that the group is not printed. 
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—m Forces stream output format. 


—n Same as the —I switch, but the owner’s user ID appears instead of the owner’s name. If used in con- 
junction with the —g switch, the owner’s group ID appears instead of the group name. 


—q Forces printing of nongraphic characters in filenames as the character “?”’. 

—r Reverses the order of sort to get reverse alphabetic or oldest first as appropriate. 

—s Gives size in 512-byte blocks, including indirect blocks for each entry. 

—t Sorts by time modified (latest first) instead of by name, as is normal. 

—u Uses time of last access instead of last modification for sorting (—t) or printing (—l). 
—x Forces columnar printing to be sorted across rather than down the page. 

The following are alternate invocations of the le command: 

If Produces the same output as Ic -F. 

Ir Produces the same output as Ic -R. 

Ix Produces the same output as Ic -x. 


The mode printed under the —I option contains 11 characters. The first character is: 


If the entry is a plain file 

d If the entry is a directory 

b If the entry is a block-type special file 

c If the entry is a character-type special file 
p_ If the entry is a named pipe 

s If the entry is a semaphore 

m If the entry is shared data (memory) 


The next 9 characters are interpreted as 3 sets of 3 bits each. The first set refers to owner permissions; 
the next to permissions to others in the same user-group; and the last to all others. Within each set the 
3 characters indicate permission respectively to read, to write, or to execute the file as a program. For a 
directory, “execute” permission is interpreted to mean permission to search the directory for a specified 
file. The permissions are indicated as follows: 


r If the file is readable 

w If the file is writable 

x If the file is executable 

— If the indicated permission is not granted 


The group-execute permission character is given as s if the file has set-group-ID mode; likewise the 
user-execute permission character is given as s if the file has set-user-ID mode. 
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The last character of the mode (normally “x” or “—”) is t if the 1000 bit of the mode is on. See 
chmod(C) for the meaning of this mode. 
When the sizes of the files in a directory are listed, a total count of blocks, including indirect blocks, is 
printed. 

Files 
/etc/passwd To get userIDs for “le —|” 


3 


/etc/group To get group IDs for “Ic —g’ 


Credit 


This utility was developed at the University of California at Berkeley and is used with permission. 


Notes 


Newline and tab are considered printing characters in filenames. The output device is assumed to be 80 
columns wide. Column width choices are poor for terminals that can tab. 
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Name 


line — Reads one line. 


Syntax 


line 


Description 


Line copies one line (up to a newline) from the standard input and writes it on the standard output. It 
returns an exit code of 1 on end-of-file and always prints at least a newline. It is often used within shell 
files to read from the user’s terminal. 


See Also 


gets(CP), sh(C) 
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Name 


In — Makes a link to a file. 


Syntax 


In filel file2 
In filel ... directory 


Description 


A link is a directory entry referring to a file; the same file (together with its size, all its protection infor- 
mation, etc). may have several links to it. There is no way to distinguish a link to a file from its ori- 
ginal directory entry. Any changes to the file are effective independent of the name by which the file is 
known. 


In the first case, /n creates a link to the existing file, file]. The file2 argument is a new name referring 
to the same file contents as file/. 


In the second case, directory is the location of a directory into which one or more links are created with 
corresponding file names. 


You cannot link to a directory or link across file systems. 


Notes 


ec” See also cp(C), mv(C), rm(C) 
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Name 


logname — Gets login name. 


Syntax 


logname 


Description 


Logname returns the contents of the environment variable $LOGNAME, which is set when a user logs 
into the system. 


See Also 


env(C), login(M), logname(S), environ(M) 
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Name 
r™ 


look — Finds lines in a sorted list. 


Syntax 


look [ —df ] string [ file ] 


Description 
Look consults a sorted file and prints all lines that begin with string. It uses binary search. 
The options d and f affect comparisons as in sort(C): 
—d Dictionary order: only letters, digits, tabs and blanks participate in comparisons. 
—f Fold. Uppercase letters compare equal to lowercase. 


If no file is specified, /usr/dict/words is assumed with collating sequence —df. 


Files 


/usr/dict/words 


See Also 


oo 


sort(C), grep(C) 
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Name 


lpr — Sends files to the lineprinter queue for printing. 


Syntax 


Ipr [ option ... ] [ name... ] 


Description 


Lpr causes the named files to be queued for printing on a lineprinter. If no names appear, the standard 
input is assumed; thus /pr may be used as a filter. 


The following options may be given (each as a separate argument and in any order) before any filename 
arguments: 


ae Makes a copy of the file and prints the copy and not the original. Normally files are linked 
whenever possible. 


—I Removes the file after sending it. 
—m When printing is complete, reports that fact by mail(C). 
=H Does not report the completion of printing by mail(C). This is the default option. 


The file /etc/default/Ipd contains the setting of the variable BANNERS, whose value is the number of 
pages printed as a banner identifying each printout. This is normally set to either’ 1 or-2. 


cy 


Files 
/etc/passwd User’s identification and accounting data 
/usr/lib/Ipd Lineprinter daemon 


/usr /spool/Ipd/* Spool area 


/etc/default/Ipd Contains BANNERS default setting 
/etc/Ipopen On some systems - sets modes on a serial line 
See Also 
banner(C) 
Notes 


Once a file has been queued for printing, it should not be changed or deleted until printing is complete. 
If you want to alter the contents of the file or to remove the file immediately, use the —c option to force 
[pr to make its own copy of the file. 
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c™ Name 


ls — Gives information about contents of directories. 


Syntax 


Is | —logtasdrucif | names 


Description 


For each directory named, /s lists the contents of that directory; for each file named, /s repeats its name 
and any other information requested. By default, the output is sorted alphabetically. When no argu- 
ment is given, the current directory is listed. When several arguments are given, the arguments are first 
sorted appropriately, but file arguments are processed before directories and their contents. There are 
several options: 


—] Lists in long format, giving mode, number of links, owner, group, size in bytes, and time of last 
modification for each file (see below). If the file is a special file, the size field will contain the major 
and minor device numbers, rather than a size. 


—o The same as —l, except that the group is not printed. 
—g The same as —l, except that the owner is not printed. 
—t Sorts by time of last modification (latest first) instead of by name. 


oo —a Lists all entries; in the absence of this option, entries whose names begin with a period (.) are not 
listed. 


—s Gives size in (512 byte) blocks, including indirect blocks, for each entry. 
—d If argument is a directory, lists only its name; often used with —I to get the status of a directory. 
—r Reverses the order of sort to get reverse alphabetic or oldest first, as appropriate. 


—u Uses time of last access instead of last modification for sorting (with the —t option) and/or printing 
(with the —l option). 


—e Uses time of last modification of the inode (mode, etc.) instead of last modification of the file for 
sorting (—t) and/or printing (—l). 


—i For each file, prints the inode number in the first column of the report. 


—f Forces each argument to be interpreted as a directory and lists the name found in each slot. This 
option turns off —l, —t, —s, and —r, and turns on —a; the order is the order in which entries appear 
in the directory. 


The mode printed under the —I option consists of 11 characters. The first character is: 


— If the entry is an ordinary file d If the entry is a directory 


— 


If the entry is a block special file 


If the entry is a character special file 


er) 


p If the entry is a named pipe 
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s If the entry is a semaphore 
m_ If the entry is a shared data (memory) file 


The next 9 characters are interpreted as 3 sets of 3 bits each. The first set refers to the owner’s permis- 
sions; the next to permissions of others in the user-group of the file; and the last to all others. Within 
each set, the 3 characters indicate permission to read, to write, and to execute the file as a program, 
respectively. For a directory, “execute” permission is interpreted to mean permission to search the 
directory for a specified file. 


The permissions are indicated as follows: 

r If the file is readable 

w_If the file is writable 

x If the file is executable 

— If the indicated permission is not granted 


The group-execute permission character is given as s if the file has set-group-ID mode; likewise, the 
user-execute permission character is given as s if the file has set-user-ID mode. The last character of the 
mode (normally x or —) is t if the 1000 (octal) bit of the mode is on; see chmod(C) for the meaning of 
this mode. The indications of set-ID and 1000 bit of the mode are capitalized if the corresponding exe- 
cute permission is not set. 


When the sizes of the files in a directory are listed, a total count of blocks including indirect blocks is 
printed. 


Files 
/etc/passwd Gets user IDs for Is —1 and Is —o 
/etc/group Gets group IDs for Is —] and ls —g 
See Also 


chmod(C), find(C), 1(C), Ic(C) 


Notes 
Newline and tab are considered printing characters in filenames. 


All switches must be given as one argument. Thus “Is —Isg” is legal, but “Is —1 —s —g” is not. 
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Name 
cy 


mail — Sends, reads or disposes of mail. 


Syntax 
mail [[—u user] [—f mailbox]] [—e] [—R] [—i] [ users ...] 


mail [—s subject] [—i] [ user ...] 


Description 


Mail is a mail processing system that supports composing of messages, and sending and receiving of 
mail between multiple users. When sending mail, a user is the name of a user or of an alias assigned to 
a machine or to a group of users. 3 


Options include: 


—u user | 
Tells mail to read the system mailbox belonging to the specified user. 


—f mailbox 
Tells mail to read the specified mailbox instead of the default user’s system mailbox. 


—e Allows escapes from compose mode when input comes from a file. 


—R Makes the mail session “read-only” by preventing alteration of the mailbox being read. Useful 
‘-_ when accessing system-wide mailboxes. 


—j Tells mail to ignore interrupts sent from the terminal. This is useful when reading or sending mail 
over telephone lines where “noise” may produce unwanted interrupts. 


—s subject 
Specifies subject as the text of the Subject: field for the message being sent. 


Sending mail 


To send a message to one or more other people, invoke mail with arguments which are the names of 
people to send to. You are then expected to type in your message, followed by a CNTRL-D at the begin- 
ning of a line. 


Reading Mail 


To read mail, invoke mail with no arguments. This will check your mail out of the system-wide direc- 
tory so that you can read and dispose of the messages sent to you. A message header is printed out for 
each message in your mailbox The current message is initially the last numbered message and can be 
printed using the print command (which can be abbreviated p). You can move among the messages 
much as you move between lines in ed, with the commands + and — moving backwards and forwards, 
and simple numbers typing the addressed message. 


If new mail arrives during the mail session you can read in the new messages with the restart command. 


Disposing of Mail 
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After examining a message you can delete (d) the message or reply (r) to it. Deletion causes the mail 
program to forget about the message. This is not irreversible, the message can be undeleted (u) by 
giving its number, or the mail session can be aborted by giving the exit (x) command. Deleted mes- 
sages will, however, usually disappear never to be seen again. 


Specifying Messages 


Commands such as print and delete often can be given a list of message numbers as arguments to apply 
to a number of messages at once. Thus “delete 1 2” deletes messages 1 and 2, while “delete 1-5” 
deletes messages | through 5. The special name “*” addresses all messages, and “$” addresses the last 
message; thus the command top which prints the first few lines of a message could be used in ae aia 
print the first few lines of all messages. 


Replying to or Originating Mail 


You can use the reply command to set up a response to a message, sending it back to the person who 
sent it. Then you can type in the text of the reply, and press CNTRL-D to send it. While you are com- 
posing a message, mail treats lines beginning with a tilde (~) as special. For instance, typing ““m” 
(alone on a line) places a copy of the current message into the response, right shifting it by one tabstop. 
Other escapes set up subject fields, add and delete recipients to the message, and allow you to escape to 
an editor to revise the message or to a shell to run some commands. (These options are be given in the 
summary below.) 


Ending a Mail Session 


You can end a mail session with the quit (q) command. Messages that have been examined go to your 
mbox file unless they have been deleted, in which case they are discarded. Unexamined messages go 
back to the post office. The —f option causes mail to read in the contents of your mbox (or the specified 
file) for processing; when you quit mail writes undeleted messages back to this file. The —i option 
Causes mail to ignore interrupts. 


Using Aliases and Distribution Lists 


It is also possible to create a personal distribution list so that, for instance, you can send mail to 
“cohorts” and have it go to a group of people. Such lists can be defined by placing a line like 


alias cohorts bill bob barry bobo betty beth bobbi 


in the file .mailrc in your home directory. The current list of such aliases can be displayed by the alias 
(a) command in mail. System-wide distribution lists can be created by editing /usr/lib/mail/aliases, see 
aliases(M); these are kept in a slightly different syntax. In mail you send, personal aliases will be ex- 
panded in mail sent to others so that they will be able to reply to the recipients. System-wide aliases 
are not expanded when the mail is sent, but any reply returned to the machine will have the system-wide 
alias expanded. 


Mail has a number of options which can be set in the .mailrc file to alter its behavior; thus “‘set askcc’”’ 
enables the “askcc” feature. (These options are summarized below.) 
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Summary 


MAIL (C) 


Each mail command is typed on a line by itself, and may take arguments following the command word. 
The command need not be typed in its entirety — the first command which matches the typed prefix is 
used. For the commands that take message lists as arguments, if no message list is given, then the next 
message forward that satisfies the command’s requirements is used. If there are no messages forward of 
the current message, the search proceeds backwards, and if there are no good messages at all, mail types 
‘“‘No applicable messages” and aborts the command. 


RETURN 


: 


alias 


Alias users 


Goes to the previous message and prints it out. If given a numeric argument n, goes to 
the nth previous message and prints it. 


Goes to the next message and prints it out. If given a numeric argument 7, goes to the 
nth next message and prints it. 


Goes to the next message and prints it out. 
Prints a brief summary of commands. 
Executes the shell command which follows. 
Prints out the current message number. 
Prints out the first message. 

Prints out the last message. 


(a) With no arguments, prints out all currently-defined aliases. With one argument, prints 
out that alias. With more than one argument, adds the users named in the second and 
later arguments to the alias named in the first argument. 


Prints system-wide list of aliases for users. At least one user must be specified. 


cd (c) Changes the user’s working directory to that specified, if given. If no directory is given, 
then changes to the user’s login directory. 

delete (d) Takes a list of messages as an argument and marks them all as deleted. Deleted mes- 
sages are not retained in the system mailbox after a quit, nor are they available to any 
command other than the undelete command. 

dp Deletes the current message and prints the next message. If there is no next message, 
mail says “no more messages.” 

echo path Expands shell metacharacters. 

edit (e) Takes a list of messages and points the text editor at each one in turn. On return from 
the editor, the message is read back in. 

exit (x) Effects an immediate return to the shell without modifying the user’s system mailbox, 
his mbox file, or his edit file in —f. 

file (fi) Prints the name of the file mail is reading. If it is a mailbox the name of the owner is 
returned. 

forward (f) Forwards the current message to the named users. Current message is indented within 
forwarded message. 
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Forward 


headers 


hold 


list 
Ipr 


mail 


mbox 


MAIL (C) 


(F) Forwards the current message to the named users. Current message is not indented 
within forwarded message. 


(h) Lists the current range of headers, which is an 18 message group. If a “+” argument 
is given, then the next 18 message group is printed, and if a “—” argument is given, the 
previous 18 message group is printed. Both “+” and “-” may take a number to view a 
particular window. If a message-list is given, it prints the specified headers. 


(ho) Takes a message list and marks each message therein to be saved in the user’s system 
mailbox instead of in mbox. Use only when the switch autombox is set. Does not override 
the delete command. 


Prints list of mail commands. 
(1) Prints out each message in a message-list on the lineprinter. 


(m) Takes as argument login names and distribution group names and sends mail to those 
people. 


(mb) Marks messages in a message list so that they are saved in the user mailbox after 
leaving mail. 


move mesg-list mesg-num 


next 


print 


quit 


reply 


Reply 


restart 


save 


set 


Shell 


size 


Places the messages specified in mesg-list after the message specified in mesg-num. If 
mesg-num is 0, mesg-list moves to the top of the mailbox. 


(n like + or RETURN) Goes to the next message in sequence and prints it. With an argu- 
ment list, types the next matching message. 


(p) Prints out each message in a message-list on the terminal display. 


(q) Terminates the session, retaining all undeleted, unsaved messages in the system 
mailbox and removing all other messages. Files marked with a star (*) are saved; files 
marked with an “M” are saved in the user mailbox. If new mail has arrived during the 
session, the message “You have new mail” is given. If given while editing a mailbox file 
with the —f flag, then the mailbox file is rewritten. The user returns to the shell, unless the 
rewrite of the mailbox file fails, in which case the user can escape with the exit command. 


(r) Takes a message list and sends mail to each message author. The default message 
must not be deleted. 


(R) Takes a message list and sends mail to each message author and each member of the 
message just like the mail command. The default message must not be deleted. 


Reads in messages that arrived during the current mail session. 


(s) Takes a message list and a filename and appends each message in turn to the end of 
the file. The filename, in quotation marks, followed by the line count and character count 
is echoed on the user’s terminal. 


(se) With no arguments, prints all variable values. Otherwise, sets option. Arguments are 
of the form “option=value” or “‘option”’. 


(sh) Invokes an interactive version of the shell. 


(si) Takes a message list and prints out the size in characters of each message. 
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(so) Reads mail commands from the file given as its only argument. 


string string mesg-list 


top 


undelete 


unset 


visual 


whois 


Searches for string in mesg-list. If no mesg-list is specified, all undeleted messages are 
searched. Case is ignored in search. 


(t) Takes a message list and prints the top few lines of each. The number of lines printed 
is controlled by the variable toplines and defaults to six. 


(u) Takes a message list and marks each one as not being deleted. 


(uns) Takes a list of option names and discards their remembered values; the inverse of set 


(v) Takes a message list and invokes vi on each message. 


Looks up a list of target mail recipients and prints the real names or descriptions of each 
recipient. If the first character of the first argument is alphabetic, the arguments are 
looked up without change. Otherwise, the arguments are assumed to be a message list, in 
the format specified in the Mail User’s Guide. For each message in the list, the “From” 
person is extracted from the header and added to list of users to be searched. 


If a target mail recipient contains a machine and user name, nothing is printed. If it is a 
private alias, “private alias” is printed. If it is a global alias, the name or description of 
the recipient is printed (contents of the $n field in the alias file). If all of the above fail, 
the user is looked up in /etc/passwd; if the user is a local user, “local user” is printed. Fi- 
nally, if none of the above tests and searches succeed, “unknown”’ is printed. 


write filename 


(w) Saves the body of the message in the named file. 


Here is a summary of the compose escapes, which are used when composing messages to perform special 
functions. Compose escapes are only recognized at the beginning of lines. 


“string 


ie 


temd 


“|emd 


Inserts the string of text in the message prefaced by a single tilde (~). If you have changed 
the escape character, then you should double that character instead. 


Prints out help for compose escapes. 
Same as CNTRL-D on a new line. 
Executes the indicated shell command, then returns to the message. 


Pipes the message through the command as a filter. If the command gives no output or 
terminates abnormally, retains the original text of the message. 


~_ mail-command 


Executes a mail command, then returns to compose mode. 


~: mail-command 


“alias 


Executes a mail command, then returns to compose mode. 


Prints list of private aliases 


“alias aliasname 


Prints names included in private aliasname. 
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“Alias Performs aliasing by first examining private aliases and then system-wide aliases using all 
three global alias files (aliases.hash, faliases, and maliases). Only the final result is printed 
(non-local mail recipients will have the complete delivery path printed). The user list is 
taken from header fields. 


“Alias users Performs aliasing by first examining private aliases and then system-wide aliases using all 
three global alias files (aliases.hash, faliases, and maliases). Only the final result is printed 
(non-local mail recipients will have the complete delivery path printed). At least one user 
must be specified. 


“b name... Adds the given names to the list of blind carbon copy recipients. 

“¢ name... Adds the given names to the list of carbon copy recipients. 

“ce name .... Same as “c above. 

“d Reads the file dead.letter from your home directory into the message. 

“e Invokes the text editor on the message collected so far. After the editing session is 


finished, you may continue appending text to the message. 


“h Edits the message header fields by typing each one in turn and allowing the user to append 
text to the end or modify the field with the current terminal erase and kill characters. 


“m mesg-list Reads the named messages into the message buffer, shifted right one tab. If no messages 
are specified, reads the current message. 


“M mesg-list Reads the named messages into the message buffer, with no indentation. If no messages 
are specified, reads the current message. 


“p Prints out the messages collected so far, prefaced by the message header fields. 
“Print Prints the real names or descriptions (in parentheses) after each recipient in a header field. 
“q Aborts the message being sent, copying the message to dead.letter in your home directory 


if save is set. 
‘T filename Reads the named file into the message buffer. 


“Return name 
Adds the given names to the Return-receipt-to field. 


“s string Causes the named string to become the current subject field. 
‘tname... Adds the given names to the direct recipient list. 
vy Invokes a visual editor (defined by the VISUAL option) on the message buffer. After you 


quit the editor, you may resume appending text to the end of your message. 
“w filename Writes the body of the message to the named file. 


Options are controlled with the set and unset commands. An option may be either a switch, in which 
case it is either on or off, or a string, in which case the actual value is of interest. The switch options in- 
clude the following: 


askee Causes you to be prompted for additional carbon copy recipients at the end of each 
message. Responding with a newline indicates your satisfaction with the current list. 
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asksubject 


autombox 


autoprint 


chron 
dot 


execmail 


ignore 


mchron 


metoo 


nosave 


quiet 


verify 


MAIL (C) 
Causes mail to prompt you for the subject of each message you send. If you respond 
with simply a newline, no subject field is sent. 
Causes all examined messages to be saved in the user mailbox unless deleted or saved. 


Causes the delete command to behave like dp — thus, after deleting a message, the next 
one will be typed automatically. 


Causes messages to be displayed in chronological order. 
Permits use of dot (.) as the end of file character when composing messages. 


Causes the underbar prompt to return before mail is finished being sent. This frees the 
user to continue while mail performs mailing functions in background. The metoo op- 
tion will not work if execmail is set. execmail is set by default. Unset execmail and set 
metoo in the user’s .mailre file to use the metoo option. 


Causes interrupt signals from your terminal to be ignored and echoed as at-signs (@). 


Causes messages to be listed in numerical order (most recently received first), but 
displayed in chronological order. 


Usually, when a group is expanded that contains the sender, the sender is removed 
from the expansion. Setting this option causes the sender to be included in the group. 
The metoo option will not work if execmail is set. execmail is set by default. Unset ex- 
ecmail and set metoo in the user’s .mailrce file to use the metoo option. 


Prevents aborted messages from being appended to the file dead./etter in your home 
directory on receipt of two interrupts (or a “q.) 


Suppresses the printing of the version header when first invoked. 


Causes each target mail recipient to be verified in the manner decribed in the whois 
command. This option permits errors made while composing messages to be corrected 
or ignored. 


The following options have string values: 


EDITOR 


SHELL 


VISUAL 


escape 


page=n 


record 


toplines 
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Pathname of the text editor to use in the edit command and “e escape. If not defined, 
then a default editor (/bin/ed) is used. 


Pathname of the shell to use in the ! command and the 7! escape. A default shell 
(/bin/sh) is used if this option is not defined. 


Pathname of the text editor (/bin/vi) to use in the visual command and ‘Vv escape. 


If defined, the first character of this option gives the character to use in the place of 
the tilde (~) to denote escapes. 


Specifies the number of lines (n) to be printed in a “page” of text when displaying 
messages. 


If defined, gives the pathname of the file used to record all outgoing mail. If not 
defined, then outgoing mail is not saved. 


If defined, gives the number of lines of a message to be printed out with the top com- 
mand; normally, the first six lines are printed. 
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Files 


/usr /spool/mail/* 
/usr/name/dead.letter 
/usr /name/mbox 

/usr /name/.mailrc 
/usr/lib/mail/aliases 
/usr/lib/mail/aliases.hash 
/usr/lib/mail/faliases 
/usr/lib/mail/maliases 
/usr/lib/mailhelp.cmd 
/usr/lib/mailhelp.esc 
/usr/lib/mailhelp.set 
/usr/lib/mail/mailre 


/usr/bin/mail 


See Also 


System mailboxes 

File where undeliverable mail is deposited 
Your old mail 

File giving initial mail commands 
System-wide aliases 

System-wide alias database 

Forwarding aliases for the local machine 
Machine aliases 

Help file 

Help file 

Help file 

System initialization file (defaults) 


The mail command 


aliases(M), aliashash(M), netutil(C) 


Credit 


This utility was developed at the University of California at Berkeley and is used with permission. 
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Name 


mesg — Permits or denies messages sent to a terminal. 


Syntax 


mesg [n] [y ] 


Description 


Mesg with argument n forbids messages via write(C) by revoking nonuser write permission on the user’s 
terminal. Mesg with argument y reinstates permission. All by itself, mesg reports the current state 
without changing it. 


Files 


/dev/tty* 


See Also 


write(C) 


Diagnostics 


Exit status is 0 if messages are receivable, | if not, 2 on error. 
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Name 


mkdir — Makes a directory. 


Syntax 


mkdir dirname ... 


Description 


Mkdir creates directories. The standard entries “dot” (.), for the directory itself, and “dot dot” (..), for 
its parent, are made automatically. 


Mkdir requires write permission in the parent directory. The permissions assigned to the new directory 
are modified by the current file creation mask set by umask (C). 
See Also 


rmdir(C), umask(C) 
Diagnostics 


Mkdir returns exit code 0 if all directories were successfully made; otherwise, it prints a diagnostic and 
returns nonzero. 
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Name 


mkfs — Constructs a file system. 


Syntax 


/etc/mkfs [ —y ] [ —n ] special proto | mn ] 


Description 


Mkfs constructs a file system by writing on the special file special according to the directions found in 
the prototype file proto. The prototype file contains tokens separated by spaces or newlines. The first 
token is the name of a file to be copied onto block zero as the bootstrap program. The second token is a 
number specifying the size of the created file system. Typically it will be the number of blocks on the 
device, perhaps diminished by space for swapping. The next token is the number of inodes in the i-list. 
The next set of tokens comprise the specification for the root file. File specifications consist of tokens 
giving the mode, the user IDs, the group IDs and the initial contents of the file. The syntax of the con- 
tents field depends on the mode. 


The mode token for a file is a 6-character string. The first character specifies the type of the file, ‘Cine 
characters —bed specify regular, block special, character special and directory files respectively.) The se- 
cond character of the type is either u or — to specify set-user-id mode or not. The third is g or — for the 
set-group-id mode. The rest of the mode is a 3-digit octal number giving the owner, group, and other 
read, write, execute permissions, see chmod(C). 


Two decimal number tokens come after the mode; they specify the user and group IDs of the owner of 
the file. 


If the file is a regular file, the next token is a pathname whence the contents and size are copied. 


If the file is a block or character special file, two decimal number tokens follow which give the major 
and minor device numbers. 


If the file is a directory, mkfs creates the entries “dot” (.) and “dot dot” (..) and then reads a list of 
names and (recursively) file specifications for the entries in the directory. The scan is terminated by a 
dollar sign ($). 


If the prototype file cannot be opened and its name consists of a string of digits, mkfs builds a file 
system with a single empty directory on it. The size of the file system is the value of proto interpreted 
as a decimal number. The number of inodes is calculated as a function of the file system size. The boot 
program is left uninitialized. 


Mkfs can also be used to create a file system image in a regular file, rather than on a special device file, 
by giving the pathname of the target file, instead of special. 


If the target file is not a regular file, then mkfs checks for an existing file system on that device. If it 
appears the device contains a file system, operator confirmation is requested before overwriting the data. 
The —y “yes” switch overrides this, and writes over any existing data without question. The —n switch 
causes mkfs to terminate without question if the target contains an existing file system. The check used 
is to read block one from the target device (block one is the super block) and see whether the bytes are 
all the same. If they are not, this is taken to be meaningful data, and confirmation is requested. 


A sample prototype specification follows: 


/stand/diskboot 
4872 110 
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d——777 3 1 

usr d——777 3 1 
sh Sew P00 1 Oi Si 
ken d——755 6 1 


$ 
b0O b——644 3100 
cO0 c-—6443100 


See Also 


filesystem(F) dir(F) 


Notes 


There is no way to specify links. 
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Name 


‘e 


mknod — Builds special files. 


Syntax 
/etc/mknod name [ ¢ ] [ b ] major minor 
/etc/mknod name p 
/etc/mknod name s 


/etc/mknod name m 


Description 


Mknod makes a directory entry and corresponding inode for a special file. The first argument is the 
name of the entry. In the first case, the second argument is b if the special file is block-type (disks, 
tape) or ¢ if it is character-type (other devices). The last two arguments are numbers specifying the 
major device type and the minor device (e.g. unit, drive, or line number), which may be either decimal 
or octal. 


The assignment of major device numbers is specific to each system. 


Mknod can also be used to create named pipes with the p option; semaphores with the s option; and 
shared data (memory) with the m option. 


c~ Only the super-user can use the first form of the syntax. 


See Also 


mknod(S) 
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Name 


mkuser — Adds a login ID to the system. 


Syntax 


/etc /mkuser 


Description 


Mkuser is used to add more user login IDs to the system. It is the preferred method for adding new 
users to the system, since it handles all directory creation and password file update. To add a new user 
to the system, mkuser requires four pieces of information: the login name, the initial password, the 
group identification, and an optional comment string for the password file. It also allows the new user 
to be assigned to a group if required, although in most cases a default group is suitable. The program 
prompts for these four items and validates the given data. The login name is checked against certain cri- 
teria (i.e., it must be at least three characters and begin with a lowercase letter). The password must 
follow standard XENIX conventions, see passwd(C). The password file comment field can be up to 20 
characters of information. 


Mkuser takes some of its parameters from a default file, /etc/default/mkuser. Currently, one may set 
the root path of home directories. An example default file is: 


HOME=/usr 


This file can be edited (by the super-user) to change this default. There are six other files in the direc- 
tory /usr/lib which may also be altered to suit local options. They are mkuser.help which is the introduc- 

ce tory explanation given by mkuser on startup, mkuser.mail which is the initial mail message sent to new 
users, mkuser.prof, the standard .profile file given to new sh shell users, mkuser.vsh, the standard .pro- 
file file given to new vsh shell users, mkuser.Jogin, the standard .Jogin file given to new csh users, and 
mkuser.cshrc, the standard .cshrc file given to new csh users. 


Mkuser prompts for the shell type to assign to the new user. The shell types available are sh (option 1), 
vsh (option 2), and csh (option 3). 


Mkuser allocates user IDs starting at 200, or the largest number used in the password file. The default 
group ID for new users is 50. The minimum group ID allowed for user accounts is 50. The program 
prompts the operator for an optional group specification. This can either be a numeric group ID, or a 
group name. If the group exists the user is added to it. If it does not exist a new entry in /etc/group is 
created. A new group cannot have a numeric ID less than 51. If a new group is to be created, and the 
operator only specifies the group name, a free group ID is assigned. Alternatively the operator can 
specify the group ID too. 


Mkuser can only be executed by the super-user. 


The minimum length of a legal password, and the minimum and maximum number of weeks used in 
password aging are specified in /etc/default/passwd by the variables PASSLENGTH, MINWEEKS and 
MAXWEEKS. For example, these variables might be set as follows: 


PASSLENGTH=6 
MINWEEKS=2 
MAXWEEKS=6 
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Files 
/etc/passwd 
/usr/spool/mail/username 
/etc/default /mkuser 
/usr/lib/mkuser/mkuser.cshrc 
/usr /lib/mkuser /mkuser.help 
/usr /lib/mkuser /mkuser.login 
/usr/lib/mkuser /mkuser.prof 
/usr/lib/mkuser /mkuser.mail 


/usr/lib/mkuser /mkuser.vsh 


See Also 


rmuser(C), passwd(C), pwadmin(C) 


June 28, 1985 Page 2 


MORE (C) MORE (C) 


Name 


more — Views a file one screen full at a time. 


Syntax 


more [| —cdflsur | [ —” | | +/inenumber | [| +/pattern | [| name... | 


Description 


This filter allows examination of a continuous text one screen full at a time. It normally pauses after 
each screen full, printing “--More--” at the bottom of the screen. If the user then types a carriage re- 
turn, one more line is displayed. If the user hits the SPACE bar, another screen full is displayed. Other 
possibilities are described below. 


The command line options are: 


i 


= 


= 


—u 


= 


Wy 


An integer which is the size (in lines) of the window which more will use instead of the default. 


More draws each page by beginning at the top of the screen and erasing each line just before it 
draws on it. This avoids scrolling the screen, making it easier to read while more is writing. This 
option is ignored if the terminal does not have the ability to clear to the end of a line. 


More prompts with the message “Hit space to continue, Rubout to abort" at the end of each screen 
full. This is useful if more is being used as a filter in some setting, such as a class, where many 
users may be unsophisticated. 


This option causes more to count logical, rather than screen lines. That is, long lines are not folded. 
This option is recommended if nroff output is being piped through wl, since the latter may generate 
escape sequences. These escape sequences contain characters that would ordinarily occupy screen 
positions, but that do not print when they are sent to the terminal as part of an escape sequence. 
Thus more may think that lines are longer than they actually are and fold lines erroneously. 


Does not treat CNTRL-L (form feed) specially. If this option is not given, more pauses after any 
line that contains a CNTRL-L, as if the end of a screen full had been reached. Also, if a file begins 
with a form feed, the screen is cleared before the file is printed. 


Squeezes multiple blank lines from the output, producing only one blank line. Especially helpful 
when viewing nroff output, this option maximizes the useful information present on the screen. 


Normally, more handles underlining, such as that produced by nroff in a manner appropriate to the 
particular terminal: if the terminal can perform underlining or has a stand-out mode, more outputs 
appropriate escape sequences to enable underlining or stand-out mode for underlined information in 
the source file. The —u option suppresses this processing. 


Normally, more ignores control characters that it does not interpret in some way. The —r option 
causes these to be displayed as “C where “C” stands for any such character. 


Normally, more exits when it comes to the end of its input. With —w however, more prompts and 
waits for any key to be struck before exiting. 


+linenumber 


Starts up at linenumber. 


+/pattern 


Starts up two lines before the line containing the regular expression pattern. 
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More looks in the file /etc/termcap to determine terminal characteristics, and to determine the default , 
window size. On a terminal capable of displaying 24 lines, the default window size is 22 lines. 7, 


More looks in the environment variable MORE to preset any flags desired. For example, if you prefer to 
view files using the —c mode of operation, the shell command “MORE=-—c’”’ in the .profile file causes all 
invocations of more to use this mode. 


If more is reading from a file, rather than a pipe, then a percentage is displayed along with the “‘-- 
More--” prompt. This gives the fraction of the file (in characters, not lines) that has been read so far. 


Other sequences which may be typed when more pauses, and their effects, are as follows (i is an optional 
integer argument, defaulting to 1): 


1 <space> 
Displays i more lines, (or another screen full if no argument is given). 


CNTRL-D 
Displays 11 more lines (a “scroll’”’). If iis given, then the scroll size is set to 7. 


d Same as CNTRL-D. 
iz Same as typing a space except that 7, if present, becomes the new window size. 
is Skips i lines and prints a screen full of lines. 


if Skips 7 screen fulls and prints a screen full of lines. 


q or Q 
Exits from more. Z 


= Displays the current line number. 


v Starts up the screen editor vi at the current line. (Note that vi may not be available with your 
system.) 7 


h or ? 
Help command; Gives a description of all the more commands. 


i /expr : 
Searches for the ith occurrence of the regular expression expr. If there are less than 7 occurrences 
of expr, and the input is a file (rather than a pipe), then the position in the file remains unchanged. 
Otherwise, a screen full is displayed, starting two lines before the place where the expression was 
found. The user’s erase and kill characters may be used to edit the regular expression. Erasing 
back past the first column cancels the search command. 


in Searches for the ith occurrence of the last regular expression entered. 


> (Single quotation mark) Goes to the point from which the last search started. If no search has been 
performed in the current file, this command goes back to the beginning of the file. 


!command 
Invokes a shell with command. The characters % and ! in “command" are replaced with the current 


filename and the previous shell command respectively. If there is no current filename, % is not ex- 
panded. The sequences “\%” and “‘\!’ are replaced by “%” and “‘!”’ respectively. 


i:n Skips to the 7th next file given in the command line (skips to last file if n doesn’t make sense). ( 
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i:p Skips to the ith previous file given in the command line. If this command is given in the middle of 
printing out a file, more goes back to the beginning of the file. If i doesn’t make sense, more skips 
back to the first file. If more is not reading from a file, the bell rings and nothing else happens. 


:-f Displays the current filename and line number. 


(q or :Q 
Exits from more (same as q or Q). 


Repeats the previous command. 


The commands take effect immediately, i.e., it is not necessary to type a carriage return. Up to the time 
when the command character itself is given, the user may hit the line kill character to cancel the numer- 
ical argument being formed. In addition, the user may hit the erase character to redisplay the ‘--More- 
-(xx%)”” message. 


The terminal is set to noecho mode by this program so that the output can be continuous. What you 
type will thus not show on your terminal, except for the slash (/) and exclamation (!) commands. 


If the standard output is not a teletype, more acts just like cat, except that a header is printed before 
each file (if there is more than one). 


A sample usage of more in previewing nroff output would be 


nroff —ms +2 doc.n | more -s 


Files 
/etc/termcap Terminal data base 


/usr/lib/more.help Help file 


See Also 


csh(CP), sh(C), environ(M) 


Credit 


This utility was developed at the University of California at Berkeley and is used with permission. 


Notes 
The wi and help options may not be available. 


Before displaying a file, more attempts to detect whether it is a non-printable binary file such as a direc- 
tory or executable binary image. If more concludes that a file is unprintable, it rightly refuses to print it. 
However, more cannot detect all possible kinds of non-printable files. 


Bugs 


When you use more on a null file, the screen displays a spurious character. 
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Name 


mount — Mounts a file structure. 


Syntax 
/etc/mount [ special-device directory [ —r ]] 


/etc/umount special-device 


Description 


Mount announces to the system that a removable file structure is present on special-device. The file 
structure is mounted on directory. The directory must already exist; it becomes the name of the root of 
the newly mounted file structure. 


The mount and umount commands maintain a table of mounted devices. If invoked with no arguments, 
for each special device mount prints the name of the device, the directory name of the mounted file 
structure, whether the file structure is readonly, and the date it was mounted. 


The optional last argument indicates that the file is to be mounted read-only. Physically write-protected 
must be mounted in this way or errors occur when access times are updated, whether or not any explicit 
write is attempted. 


Umount removes the removable file structure previously mounted on device special-device. 


Files 


/etc/mnttab Mount table 


See Also 


umount(C), mount(S), mnttab(F) 


Diagnostics 
Mount issues a warning if the file structure to be mounted is currently mounted under another name. 


Busy file structures cannot be dismounted with umount. A file structure is busy if it contains an open 
file or some user’s working directory. 


Notes 


Some degree of validation is done on the file structure, however it is generally unwise to mount corrupt 
file structures. 


Be warned that when in single-user mode, the commands that look in /etc/mnttab for default arguments 
(for example df, ncheck, quot, mount, and umount) give either incorrect results (due to a corrupt 
/etc/mnttab from a non-shutdown stoppage) or no results (due to an empty mnttab from a shutdown 


stoppage). 


When multi-user this is not a problem; /etc/rc initializes /etc/mnttab to contain only /dev/root and sub- 
sequent mounts update it appropriately. 
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The mount(C) and umount(C) commands use a lock file to guarantee exclusive access to /etc/mnttab, 
the commands which just read it (those mentioned above) do not, so it is possible to they may hit a 
window during which it is corrupt. This is not a problem in practice since mount and umount are not 
frequent operations. 


For the purpose of system security, this command is available only to the super user. 
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Name 


mv — Moves or renames files and directories. 


Syntax 
mv filel file2 


my file ... directory 


Description 
My moves (changes the name of) filel to file2. 


If file2 already exists, it is removed before file] is moved. If file2 has a mode which forbids writing, my 
prints the mode (see chmod(S)) and reads the standard input to obtain a line; if the line begins with y, 
the move takes place; if not, mv exits. 


In the second form, one or more files are moved to the directory with their original filenames. 


My refuses to move a file onto itself. 
See Also 
cp(C), chmod(S), copy(C) 


Cy Notes 


If filel and file2 lie on different file systems, my must copy the file and delete the original. In this case 
the owner name becomes that of the copying process and any linking relationship with other files is lost. 
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Name 


ncheck — Generates names from inode numbers. 


Syntax 


ncheck [ —i numbers ] [ —a] [ —s ] [ file-system | 


Description 


Ncheck with no argument generates a pathname vs. inode number list of all files on the set of file sys- 
tems specified in /etc/mnttab. The two characters “/.” are appended to the names of directory files. 
The —i option reduces the report to only those files whose inode numbers follow. The —a option allows 
printing of the names . and .., which are ordinarily suppressed. The —s option reduces the report to 
special files and files with set-user-ID mode; it is intended to discover concealed violations of security 
policy. A single filesystem may be specified rather than the default list of mounted file systems. 

Files 


/etc/mnttab 


See Also 


fsck(C), sort(C) 


Diagnostics 


When the file system structure is improper, ?? denotes the “parent” of a parentless file and a pathname 
beginning with ... denotes a loop. 


Notes 


See Notes under mount(C). 
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Name 


netutil — Administers the XENIX network. 


Syntax 


netutil [ —option | 


Description 


The netutil command allows the user to create and maintain a network of XENIX machines. A Micnet 
network is a link through serial lines of two or more XENIX systems. It is used to send mail between 
systems with the mail(C) command, transfer files between systems with the rcp(C) command, and exe- 
cute commands from a remote system with the remote(C) command. 


The netutil command is used to create and distribute the data files needed to implement the network. It 
is also used to start and stop the network. The option argument may be any one of install, save, restore, 
start, stop, or the numbers | through 5 respectively. 


The install option interactively creates the data files needed to run the network. The save option saves 
these files on floppy disks, allowing them to be distributed to the other systems in the network. The res- 
tore option copies the data files from floppy disk back to a system. The start option starts the network. 
The stop option stops the network. An option may also be any decimal digit in the range | to 5. If in- 
voked without an option, the command displays a menu from which to choose one. Once an option is 
selected, it prompts for additional information if needed. 


A network must be installed before it can be started. Installation consists of creating appropriate confi- 
guration files with the install option. This option requires the name of each machine in the network, the 
serial lines to be used to connect the machines, the speed of transmission for each line, and the names of 
the users on each machine. Once created, the files must be distributed to each computer in the network 
with the save and restore options. The network is started by using the start option on each machine in 
the network. Once started, mail and remote commands can be passed along the network. A record of 
the transmissons between computers in a network can be kept in the network log files. Installation of 
the network is described in the XENIX Operations Guide. 


Files 


/bin/netutil 
See Also 


aliases(M), aliashash(M), mail(C), micnet(M), remote(C), rep(C), systemid(M), top(M) XENIX Opera- 
tions Guide 
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Name 


newgrp — Logs user in to a new group. 


Syntax 


newegrp [ group | 


Description 


Newgrp changes the group identification of its caller. The same person remains logged in, and the 
current directory is unchanged, but calculations of access permissions to files are performed with respect 
to the new group ID. 


Newgrp without an argument changes the group identification to the group in the password file; in effect 
it changes the group identification back to the caller’s original group. 


A password is demanded if the group has a password and the user himself does not, or if the group has a 
password and the user is not listed in /ete/group as being a member of that group. 


When most users log in, they are members of the group named other. 


Files 


/etc/group 


/etc/passwd 


See Also 


login(M), group(M) 


Notes 
There is no convenient way to enter a password into /etc/group. 


Use of group passwords is not encouraged, because, by their very nature, they encourage poor security 
practices. Shell variables are not preserved when invoking this command unless they are explicitly ex- 
ported. 
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Name 


news — Print news items. 


Syntax 


news [ —a ] [ —n | [ —s ] [ items ] 


Description 


News is used to keep the user informed of current events. By convention, these events are described by 
files in the directory /usr/news. 


When invoked without arguments, news prints the contents of all current files in /usr/news, most recent 
first, with each preceded by an appropriate header. News stores the “currency” time as the modifica- 
tion date of a file named .news time in the user’s home directory (the identity of this directory is deter- 
mined by the environment variable $HOME); only files more recent than this currency time are con- 
sidered “current.” 


The —a option causes news to print all items, regardless of currency. In this case, the stored time is not 
changed. 


The —n option causes news to report the names of the current items without printing their contents, and 
without changing the stored time. 


The —s option causes news to report how many current items exist, without printing their names or con- 
tents, and without changing the stored time. 


All other arguments are assumed to be specific news items that are to be printed. 
If the INTERRUPT key is struck during the printing of a news item, printing stops and the next item is 
started. Another INTERRUPT within one second of the first causes the program to terminate. 
Files 
/usr /news/* 
$HOME/.news_time 
See Also 


profile(M), environ(M). 
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Name 


nice — Runs a command at a different priority. 


Syntax 


nice [| —increment |] command [ arguments | 


Description 


Nice executes command with a lower CPU scheduling priority. Priorities range from 0 to 39, where 0 is 
the highest priority and 39 is the lowest. Be default commands have a priority of 20. If an —increment 
argument is given where increment is in the range 1-19, increment is added to the default priority of 20 
to produce a numerically higher priority, meaning a Jower scheduling priority. If no increment is given, 
an increment of 10 to produce a priority of 30 is assumed. 


The super-user may run commands with priority higher than normal by using a double negative incre- 
ment. For example, an argument of --10 would decrement the default to produce a priority of 10, which 
is a higher scheduling priority than the default of 20. 


See Also 


nohup(C), nice(S) 


Diagnostics 


cc 


Nice returns the exit status of the subject command. 


Notes 


An increment larger than 19 is equivalent to 19. 
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Name 


nl — Adds line numbers to a file. 


Syntax 


nl [—htype] [—btype] [—ftype] [—vstart#] [-iincr] [—p] [—-Inum] [—ssep] [—wwidth] [—nformat] file 


Description 


NI reads lines from the named file, or the standard input if no file is named, and reproduces the lines on 
the standard output. Lines are numbered on the left in accordance with the command options in effect. 


NI views the text it reads in terms of logical pages. Line numbering is reset at the start of each logical 
page. A logical page consists of a header, a body, and a footer section. Empty sections are valid. Dif- 
ferent line numbering options are independently available for header, body, and footer (e.g. no numbe- 
ring of header and footer lines while numbering blank lines only in the body). 


The start of logical page sections is signaled by input lines containing nothing but the following 
character(s): 


Page Section Line Contents 


Header VA 
Body Aes 
Footer ‘ 


Unless signaled otherwise, n/ assumes the text being read is in a single logical page body. 


Command options may appear in any order and may be intermingled with an optional filename. Only 
one file may be named. The options are: 


—btype Specifies which logical page body lines are to be numbered. Recognized types and their 
meaning are: a, number all lines; t, number lines with printable text only; n, no line numbe- 
ring; pstring, number only lines that contain the regular expression specified in string. De- 
fault type for logical page body is t (text lines numbered). 


—htype Same as —btype except for header. Default type for logical page header is n (no lines num- 


bered). 
—ftype Same as —btype except for footer. Default for logical page footer is n (no lines numbered). 
—p Does not restart numbeving at logical page delimiters. 


—ystart# Start# is the initial value used to number logical page lines. Default is 1. 
—iincr Incr is the increment value used to number logical page lines. Default is 1. 


—ssep Sep is the character(s) used in separating the line number and the corresponding text line. 
Default sep is a tab. 


—wwidth Width is the number of characters to be used for the line number. Default width is 6. 


—nformat Format is the line numbering format. Recognized values are: In, left justified, leading zeroes 
supressed; rn, right justified, leading zeroes supressed; rz, right justified, leading zeroes kept. 
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Default format is rn (right justified). 
—Inum Num is the number of blank lines to be considered as one. For example, —I2 results in only 


the second adjacent blank being numbered (if the appropriate —ha, —ba, and/or —fa option 
is set). Default is 1. 


See Also 


pr(C) 
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Name 


nohup — Runs a command immune to hangups and quits. 


Syntax 


nohup command [ arguments | 


Description 


Nohup executes command with hangups and quits ignored. If output is not redirected by the user, it 
will be sent to nohup.out. If nohup.out is not writable in the current directory, output is redirected to 
$SHOME/nohup.out. 


See Also 


nice(C), signal(S) 
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Name 


OD (C) 


od — Displays files in octal format. 


Syntax 


od [—bedox] [ file ] [ [ + Joffset[ . ][ b ] ] 


Description 


Od displays file in one or more formats as selected by the first argument. If the first argument is mis- 


sing, — 
—b 


zag 


—d 
—o 


—X 


o is default. The meanings of the format options are: 
Interprets bytes in octal. 


Interprets bytes in ASCII. Certain nongraphic characters appear as C escapes: null=\0, back- 
space=\b, form feed=\f, newline=\n, return=\r, tab=\t; others appear as 3-digit octal numbers. 


Interprets words in decimal. 
Interprets words in octal. 


Interprets words in hex. 


The file argument specifies which file is to be displayed. If no file argument is specified, the standard 
input is used. 


The offset argument specifies the offset in the file where displaying is to start. This argument is nor- 


mally 1 


nterpreted as octal bytes. If . is appended, the offset is interpreted in decimal. If b is appended, 


the offset is interpreted in blocks. If the file argument is omitted, the offset argument must be preceded 


byF: 


The display continues until end-of-file. 


See Also 


hd(C), 


adb(CP) 


June 28, 1985 Page 1 


PACK (C) PACK (C) 


o™ Name 


pack, pcat, unpack — Compresses and expands files. 


Syntax 
pack [ — |] name... 
peat name... 


unpack name... 


Description 


Pack attempts to store the specified files in a compressed form. Wherever possible (and useful), each 
input file name is replaced by a packed file name.z with the same access modes, access and modified 
dates, and owner as those of name. If pack is successful, name will be removed. Packed files can be re- 
stored to their original form using unpack or pcat. 


Pack uses Huffman (minimum redundancy) codes on a byte-by-byte basis. If the — argument is used, 
an internal flag is set that causes the number of times each byte is used, its relative frequency, and the 
code for the byte to be printed on the standard output. Additional occurrences of — in place of name 
will cause the internal flag to be set and reset. 


The amount of compression obtained depends on the size of the input file and the character frequency 

distribution. Because a decoding tree forms the first part of each .z file, it is usually not worthwhile to 

on pack files smaller than three blocks, unless the character frequency distribution is very skewed, which 
: may occur with printer plots or pictures. 


Typically, text files are reduced to 60-75% of their original size. Load modules, which use a larger 
character set and have a more uniform distribution of characters, show little compression, the packed 
versions being about 90% of the original size. 


Pack returns a value that is the number of files that it failed to compress. 
No packing will occur if: 

— The file appears to be already packed 

— The filename has more than 12 characters 

— The file has links 

— The file is a directory 

— The file cannot be opened 

— No disk storage blocks will be saved by packing 
— A file called name.z already exists 

— The .z file cannot be created 

— AnJ/O error occurred during processing 


The last segment of the filename must contain no more than 12 characters to allow space for the ap- 
pended .z extension. Directories cannot be compressed. 
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Pcat does for packed files what cat(C) does for ordinary files. The specified files are unpacked and 
written to the standard output. Thus to view a packed file named name.z use: ww 
pcat name.z 
or just: 
pcat name 


To make an unpacked copy, say nnn, of a packed file named name.z (without destroying name.z) use 
the command: 


peat name >nnn 
Pcat returns the number of files it was unable to unpack. Failure may occur if: 
— The filename (exclusive of the .z) has more than 12 characters 
— The file cannot be opened 
— The file does not appear to be the output of pack 


Unpack expands files created by pack. For each file name specified in the command, a search is made 
for a file called name.z (or just name, if name ends in .z). If this file appears to be a packed file, it is 
replaced by its expanded version. The new file has the .z suffix stripped from its name, and has the 
same access modes, access and modification dates, and owner as those of the packed file. 


Unpack returns a value that is the number of files it was unable to unpack. Failure may occur for the 
same reasons that it may in pcat, as well as in a file where the “unpacked” name already exists, or if the ‘ » 
unpacked file cannot be created. ww, 
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Name 


passwd — Changes login password. 


Syntax 


passwd name 


Description 
This command changes (or installs) a password associated with the login name. 


The program prompts for the old password (if any) and then for the new one (twice). The user must 
supply these. Passwords can be of any reasonable length, but only the first eight characters of the 
password are significant. The minimum number of characters allowed in a new password is determined 
by the PASSLENGTH variable. Although the minimum can be 3, a minimum of 5 characters is strongly 
recommended since passwords shorter than this are much easier to guess or discover by trial and error. 


Only the owner of the name or the super-user may change a password; the owner must prove he knows 
the old password. Only the super-user can create a null password. 


The password file is not changed if the new password is the same as the old password, or if the password 
has not “‘aged”’ sufficiently; see passwd(M)). 


The minimum length of a legal password, and the minimum and maximum number of weeks used in 
password aging are specified in /etc/default/passwd by the variables PASSLENGTH, MINWEEKS and 
MAXWEEKS. If not explicitly set, the default values for these variables are: 


MINWEEKS=0 
PASSLENGTH=0 
MAX WEEKS=999 


MINWEEKS and MAXWEEKS values must be in the range 0 to 63. 
Files 


/etc/default /passwd 
/etc/passwd 


See Also 


login(M), pwadmin(C), crypt(S), default(M), passwd(M) 
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Name 


pr — Prints files on the standard output. 


Syntax 


pr [ options ] [ files ] 


Description 


Pr prints the named files on the standard output. If file is —, or if no files are specified, the standard 
input is assumed. By default, the listing is separated into pages, each headed by the page number, date 
and time, and the name of the file. 


By default, columns are of equal width, separated by at least one space; lines which do not fit are trun- 
cated. If the —s option is used, lines are not truncated and columns are separated by the separation 
character. 


If the standard output is associated with a terminal, error messages are withheld until pr has completed 
printing. 


Options may appear singly or be combined in any order. Their meanings are: 


+k Begins printing with page k (default is 1). 


ye Produces k-column output (default is 1). The options —e and —i are assumed for multicolumn 
output. 
ae | Prints multicolumn output across the page. 


—m Merges and prints all files simultaneously, one per column (overrides the —k, and —a options). 
—d Double-spaces the output. 


—eck Expands input tabs to character positions k+1, 2*k+1, 3*k+1, etc. If k is 0 or is omitted, de- 
fault tab settings at every 8th position are assumed. Tab characters in the input are expanded 
into the appropriate number of spaces. If c (any nondigit character) is given, it is treated as the 
input tab character (default for c is the tab character). 


—ick In output, replaces whitespace wherever possible by inserting tabs to character positions k+1, 
2*k+1, 3*k+1, etc. If k is O or is omitted, default tab settings at every 8th position are as- 
sumed. If c (any nondigit character) is given, it is treated as the output tab character (default 
for c is the tab character). 


—nck Provides k-digit line numbering (default for k is 5). The number occupies the first k+1 
character positions of each column of normal output or each line of —m output. If c (any non- 
digit character) is given, it is appended to the line number to separate it from whatever follows 
(default for c is a tab). 


—wk Sets the width of a line to k character positions (default is 72 for equal-width multicolumn 
output, no limit otherwise). 


—ok Offsets each line by k character positions (default is 0). The number of character positions per 
line is the sum of the width and offset. 


—lk Sets the length of a page to k lines (default is 66). 
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—h Uses the next argument as the header to be printed instead of the filename. 


—p Pauses before beginning each page if the output is directed to a terminal (pr will ring the bell at ww 
the terminal and wait for a carriage return). 


=< Uses form feed character for new pages (default is to use a sequence of linefeeds). Pauses 
before beginning the first page if the standard output is associated with a terminal. 


—r Prints no diagnostic reports on failure to open files. 


of Prints neither the 5-line identifying header nor the 5-line trailer normally supplied for each page. 
Quits printing after the last line of each file without spacing to the end of the page. 


—sc Separates columns by the single character c instead of by the appropriate number of spaces (de- 
fault for c is a tab). 
Examples 
The following prints file/ and file2 as a double-spaced, three-column listing headed by “file list’: 
pr —3dh "file list" filel file2 
The following writes file1 on file2, expanding tabs to columns 10, 19, 28, 37,...: 


pr —e9. —t <filel .>file2 


See Also 


cat(C) VW 
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Name 


PS (C) 


ps — Reports process status. 


Syntax 


ps [ options | 


Description 


Ps prints certain information about active processes. Without options, information is printed about pro- 
cesses associated with the current terminal. Otherwise, the information that is displayed is controlled by 
the following options: 


=a 
—d 


—a 


| 

—c corefile 
—s swapdev 
—n namelist 


—t tlist 


—p plist 


—u ulist 


—g glist 


Prints information about all processes. 
Prints information about all processes, except process group leaders. 


Prints information about all processes, except process group leaders and processes not asso- 
ciated with a terminal. 


Generates a full listing. (Normally, a short listing containing only process ID, terminal 
(“tty”) identifier, cumulative execution time, and the command name is printed.) See 
below for meaning of columns in a full listing. 

Generates a Jong listing. See below. 

Uses the file corefile in place of /dev/mem. 

Uses the file swapdev in place of /dev/swap. This is useful when examining a corefile. 
The argument is taken as the name of an alternate namelist (/xenix is the default). 
Restricts listing to data about the processes associated with the terminals given in flist, 
where flist can be in one of two forms: a list of terminal identifiers separated from one 
another by a comma, or a list of terminal identifiers enclosed in double quotes and 


separated from one another by a comma and/or one or more spaces. 


Restricts listing to data about processes whose process ID numbers are given in plist, 
where plist is in the same format as flist. 


Restricts listing to data about processes whose user ID numbers or login names are given 
in ulist, where ulist is in the same format as ¢/ist. In the listing, the numerical user ID is 
printed unless the —f option is used, in which case the login name is printed. 


Restricts listing to data about processes whose process groups are given in glist, where 
glist is a list of process group leaders and is in the same format as ¢/ist. 


The column headings and the meaning of the columns in a ps listing are given below; the letters f and | 
indicate the option (full or Jong) that causes the corresponding heading to appear; all means that the 
heading always appears. Note that these two options only determine what information is provided for a 
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process; they do not determine which processes will be listed. 


F (1) 
S (1) 
UID (f,1) 
PID (all) 
PPID (f,1) 
C (f,1) 
STIME  (f) 
PRI (1) 
NI (1) 
ADDR (1) 
SZ (1) 
WCHAN (1) 
TTY (all) 
TIME (all) 
CMD (all) 


A status word consisting of flags associated with the process. Each flag is associated 
with a bit in the status word. These flags are added to form a single octal number. 
Process flag bits and their meanings are: 
01 in core; 
02 system process; 
04 locked in core (e.g., for physical I/O); 
10 being swapped; 
20 being traced by another process. 
The state of the process: 
non-existent; 
sleeping; 
waiting; 
running; 
intermediate; 
terminated; 
stopped. 
The user ID number of the process owner; the login name is printed under the —f op- 
tion. 
The process ID of the process; it is possible to kill a process if you know this datum. 
The process ID of the parent process. 
Processor utilization for scheduling. 
Starting time of the process. 
The priority of the process; higher numbers mean lower priority. 
Nice value; used in priority computation. 
The memory address of the process, if resident; otherwise, the disk address. 
The size in blocks of the core image of the process, but not including the size of text 
shared with other processes. Since this size includes the current size of the stack, it 
will vary as the stack size varies. 
The event for which the process is waiting or sleeping; if blank, the process is running. 
The controlling terminal for the process. 
The cumulative execution time for the process. 
The command name; the full command name and its arguments are printed under the 
—f option. 


IN“7ENO 


A process that has exited and has a parent, but has not yet been waited for by the parent, is marked 


<defunct>. 


Under the —f option, ps tries to determine the command name and arguments given when the process 
was created by examining memory or the swap area. Failing this, the command name, as it would ap- 
pear without the —f option, is printed in square brackets. 


Files 

/xenix system namelist 

/dev/mem memory 

/dev searched to find swap device and terminal (“tty”) names. 
See Also 


kill(C), nice(C) 
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Notes 


Things can change while ps is running; the picture it gives is only a close approximation to reality. 


Some data printed for defunct processes are irrelevant. 
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Name 


PSTAT (C) 


pstat — Reports system information. 


Syntax 


pstat [ —aixptf |] [ —u ubase | [ —c corefile | 
[ —n namelist ] [ file ] 


Description 


Pstat interprets the contents of certain system tables. Pstat searches for these tables in /dev/mem and 
/dev/kmem. With the file given, the tables are sought in the specified file rather than /dev/mem. Simi- 
larly, the —e option allows one to specify a corefile rather than /dev/kmem for the search. The required 
namelist is taken from /xenix. Options are: 


“a 


—i 


<a 
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Under —p, describe all process slots rather than just active ones. 


Print the inode table with these headings: 
LOC The core location of this table entry. 
FLAGS Miscellaneous state variables encoded thus: 
Locked 
Update time filesystem(F) must be corrected 
Access time must be corrected 
File system is mounted here 
Wanted by another process (L flag is on) 
Contains a text file 
Changed time must be corrected 
CNT Number of open file table entries for this inode. 
DEV Major and minor device number of file system in which this inode resides. 
INO I-number within the device. 
MODE Mode bits, see chmod(S). 
NLK ~~ Number of links to this inode. 
UID User ID of owner. 
SIZ /DEV 
Number of bytes in an ordinary file, or major and minor device of special file. 


QHsezerar 


Prints the text table with these headings: 
LOC The core location of this table entry. 
FLAGS Miscellaneous state variables encoded thus: 


T  ptrace(S) in effect 

W Text not yet written on swap device 

L__ Loading in progress 

K Locked 

w Wanted (L flag is on) 
DADDR 

Disk address in swap, measured in multiples of BSIZE bytes. 
CADDR 


Core address, measured in units of memory management resolution. 
SIZE Size of text segment, measured in units of memory management resolution. 
IPTR Core location of corresponding inode. 
CNT Number of processes using this text segment. 
CCNT Number of processes in core using this text segment. 
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—p Prints process table for active processes with these headings: 
LOG The core location of this table entry. 
S Run state encoded thus: 


0 No process 

Waiting for some event 

Runnable 

Being created 

Being terminated 

Stopped under trace 

F Miscellaneous state variables, ORed together: 

01 Loaded 
02 The scheduler process 
04 Locked 
010 
Swapped out 
020 
Traced 
040 
Used in tracing 
0100 
Locked in by Jock(S). 

PRI Scheduling priority, see nice(S). 

SIGNAL 
Signals received (signals 1-16 coded in bits 0-15), 

UID Real user ID. 

TIM Time resident in seconds; times over 127 coded as 127. 

CPU Weighted integral of CPU time, for scheduler. 

NI Nice level, see nice(S). 

PGRP Process number of root of process group (the opener of the controlling terminal). 

PID The process ID number. 

PPID _ The process ID of parent process. 

ADDR If in core, the physical address of the “‘u-area” of the process measured in units of 
memory management resolution. If swapped out, the position in the swap area 
measured in multiples of BSIZE bytes. 

SIZE — Size of process image, measured in units of memory management resolution. 

WCHAN 
Wait channel number of a waiting process. 

LINK _ Link pointer in list of runnable processes. 

TEXTP If text is pure, pointer to location of text table entry. 

CLKT Countdown for alarm(S) measured in seconds. 


Nn RP We 


=f Print table for terminals with these headings: 

RAW Number of characters in raw input queue. 
CAN Number of characters in canonicalized input queue. 
OUT Number of characters in output queue. 
IMODE Corresponds to c_iflag field in termio structure, see tty(M). 
OMODE 

Corresponds to c_oflag field in termio structure, see tty(M). 
CMODE 

Corresponds to c_cflag field in termio structure, see tty(M). 
LMODE 

Corresponds to c Iflag field in termio structure, see tty(M). 
ADDR Physical device address. 
DEL Number of delimiters (newlines) in canonicalized input queue. 
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COL Calculated column position of terminal. 
STATE Miscellaneous state variables encoded thus: 
waiting for open to complete 

open 

has special (output) start routine 
Carrier is on 

busy doing output 

process is awaiting output 

open for exclusive use 

hangup on close 

PGRP Process group for which this is controlling terminal. 


Ix>wONOs 


—u ubase 
Print information about a user process. Ubase is the hexadecimal location of the process in 
main memory. The address may be obtained by using the long listing ( —I option) of the 
ps(C) command. 


—c corefile 
Use the file corefile in place of /dev/kmem. 


—n namelist 
Use the file namelist as an alternate namelist in place of /xenix. 


ee | Print the open file table with these headings: 
LOC The core location of this table entry. 
FLG Miscellaneous state variables encoded thus: 
R_ Open for reading 
W Open for writing 
P ‘Pipe 
CNT Number of processes that know this open file. 
INO The location of the inode table entry for this file. 
OFFS The file offset, see /seek(S). 


Files 


/xenix Namelist 


/dev/mem Default source of tables 


See Also 


ps(C), stat(S), filesystem(F) 
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Name 

pwadmin — Performs password aging administration. 
Syntax 

pwadmin | —min weeks —max weeks ] options 
Description 


Pwadmin is used to examine and modify the password aging information in the password file. The op- 
tions one can specify are as follows: 


—d user 

Displays the password aging information. 
—f user 

Forces the user to change his password at the next login. 
—¢c user 

Prevents the user from changing his password. 


—a user 
Enables password aging for the given user. This option sets the minimum number of weeks that 
the user must wait before changing his password and the maximum number of weeks that a user 
can keep his current password to the values defined by the MINWEEKS and MAXWEEKS vari- 
ables in the /etc/default/passwd file. If the file is not found or the defined values are not in the 
range 0 to 63, the default values 2 and 4 are used. 


—n user 
Disables the password aging feature. 


—min weeks 
Enables password aging and sets the minimum number of weeks before the user can change his 
password to weeks. (This prevents him from changing his password back to the old one). 


—max weeks 
Enables password aging and sets the number of weeks that the user can keep his current 
password to weeks. 


Files 

/etc/passwd 
See Also 

passwd(C), passwd(M) 
Notes 


The user must not attempt to force a new password by setting both the —min and —max values to zero. 
To force a password, use the —f option. 


The user must not attempt to prevent further password changes by setting the —min value greater than 
the —max value. To prevent changes, use the —c option. 
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Name 


pwcheck — Checks password file. 


Syntax 


pweheck [file] 


Description 


Pwcheck scans the password file and checks for any inconsistencies. The checks include validation of 
the number of fields, login name, user ID, group ID, and whether the login directory and optional pro- 
gram name exist. The default password file is /ete/passwd. 


Files 


/etc/passwd 


See Also 


grpcheck(C), group(M), passwd(M) 
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Name 


pwd — Prints working directory name. 


Syntax 


pwd 


Description 


Pwd prints the pathname of the working (current) directory. 


See Also 


cd(C) 


Diagnostics 


399 


“Cannot open ..” and “Read error in ..” indicate possible file system trouble. In such cases, see the 
Xenix Operations Guide for information on fixing the file system. 
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Name 


quot — Summarizes file system ownership. 


Syntax 


quot [ option ] ... [ filesystem ] 


Description 


Quot prints the number of blocks in the named filesystem currently owned by each user. If no 
filesystem is named, the file systems given in /etc/mnttab are examined. 


The following options are available: 


—n Causes the following pipeline to produce a list of all files and their owners: 


ncheck filesystem | sort +0n | quot —n filesystem 


—e Prints three columns giving file size in blocks, number of files of that size, and cumulative total of 
blocks in that size or smaller file. Data for files of size greater than 499 blocks are included in the 
figures for files of exactly size 499. 


—f Prints count of number of files as well as space owned by each user. 


Files 

/etc/passwd Gets user names 

/etc/mnttab Contains list of mounted file systems 
See Also 


du(C), Is(C) 


Notes 
Holes in files are counted as if they actually occupied space. 


See also Notes under mount(C). 
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Name 


random — Generates a random number. 


Syntax 


random [—s] [ scale | 


Description 


Random generates a random number on the standard output. and returns the number as its exit value. 
By default this number is either 0 or 1, ie., scale is 1 by default. If scale is given a value between 1 
and 255, then the range of the random value is from 0 to scale. If scale is greater than 255 an error 
message is printed. 


With the —s “silent” option is given, then the random number is returned as an exit value but is not 
printed on the standard output. If an error occurs, random returns an exit value of zero. 
See Also 


rand(S) 


Notes 


This command does not perform any floating point computations. 


-_ 


Random uses the time of day as a seed. 
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Name 


rcp — Copies files across XENIX systems. 


Syntax 


rep [ options ] [srcmachine:]srcfile [destmachine:]destfile 


Description 


Rep copies files between systems in a Micnet network. The command copies the srmachine:srcfile to 
destmachine:destfile, where srcmachine: and destmachine: are optional names of systems in the network, 
and srcfile and destfile are pathnames of files. If a machine name is not given, the name of the current 
system is assumed. If — is given in place of srcfile, rcp uses the standard input as the source. Direc- 
tories named on the destination machine must be publicly writable, and directories and files named on a 
remote source machine must be publicly readable. 


The available options are: 
—m Mails and reports completion of the command, whether there is an error or not. 
—u[machine:]|user 
Any mail goes to the named user on machine. The default machine is the machine on which rcp is 


invoked. 


Rep is useful for transferring small numbers of files across the network. The network consists of dae- 
mons that periodically awaken and send files from one system to another. The network must be be in- 
stalled using netutil(C) before rcp can be used. Also, to enable transfer of files from a remote system, 
the line 


rcp=/usr/bin/rcep 


must be added to the default file /etc/default/micnet on the systems in the network. 


Example 


rcp —m machinel:/etc/mnttab /tmp/vtape 


See Also 


netutil(C), remote(C), mail(C), micnet(M) 


Diagnostics 


If an error occurs mail is sent to the user. 


Notes 
Full pathnames must be specified for remote files. 


Rep handles binary data files transparently, no extra options or protocols are needed to handle them. 
Wildcards are not expanded on the remote machine. 
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Name 


red — Invokes a restricted version of ed(C). 


Syntax 


red [ file | 


Description 


Red is a restricted version of ed(C). It will only allow editing of files in the current directory. It prohi- 
bits executing sh(C) commands via the ! command. Red displays an error message on any attempt to by- 
pass these restrictions. 


In general, red does not allow commands like 
'date 

or 
Ish 

Furthermore, red will not allow pathnames in its command line. For example, the command 
red /etc/passwd 


when the current directory is not /etc causes an error. 


See Also 


ed(C), rsh(C). 
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Name 


remote — Executes commands on a remote XENIX system. 


Syntax 


remote [ — ] [ —f file ] [ —m ] [ —u user] machine command [ arguments | 


Description 


Remote is a limited networking facility that permits execution of XENIX commands across serial lines. 
Commands on any connected system may be executed from the host system using remote. A command 
line consisting of command and any blank-separated arguments is executed on the remote machine:. A 
machine’s name is located in the file /etc/systemid. Note that wild cards are not expanded on the 
remote machine, so they should not be specified in arguments. The optional —m switch causes mail to be 
sent to the user telling whether the command is successful. 


The available options follow: 


- A dash signifies that standard input is used as the standard input for command on the 
remote machine:. Standard input comes from the local host and not from the remote 
machine. 


=f file Use the specified file as the standard input for command on the remote machine:. The file 
exists on the local host and not on the remote machine. 


oO —m Mails the user to report completion of the command. By default, mail reports only errors. 


—u Any report mail goes to the named user rather than to the executor of the command. The 
user name may have a prepending machine: name to signify a user on some remote system. 


A network of systems must first be set up and the proper daemons initialized using netutil(C) before 
remote can be successfully used. 

Example 
The following command executes an /s command on the remote directory /tmp: 


remote —m machinel Isd —1 /tmp 


See Also 


rcp(C), mail(C), netutil(C) 


Notes 


The mail command uses the equivalent of remote to send mail between machines. 


Note 


/usr/lib/mail/mail.mn is linked to /usr/bin/remote. 
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Name 


restore, restor — Invokes incremental file system restorer. 


Syntax 


restore key [| arguments | 


restor key [ arguments | 


Description 


Restore is used to read archive media backed up with the backup(C) command. The key specifies what 
is to be done. Key is one of the characters rRxt, optionally combined with f. Restor is an alternate 
spelling for the same command. 


f Uses the first argument as the name of the archive (backup device /dev/*) instead of the default. 


r,R The archive is read and loaded into the file system specified in argument. This should not be done 
lightly (see below). If the key is R, restore asks which archive of a multivolume set to start on. 
This allows restore to be interrupted and then restarted (an fsck must be done before the restart). 


x Each file on the archive named by an argument is extracted. The filename has all “mount” prefixes 
removed; for example, if /usr is a mounted file system, /usr/bin/Ipr is named /bin/Ipr on the ar- 
chive. The extracted file is placed in a file with a numeric name supplied by restore (actually the 
inode number). In order to keep the amount of archive read to a minimum, the following procedure 

co is recommended: 


1. Mount volume 1 of the set of backup archives. 
2. Type the restore command with the appropriate key and arguments. 


3. Restore will check dumpdir, then announce whether or not it found the files, give the numeric 
name that it will assign to the file, and in the case of a tape, rewind to the start of the archive. 


4. It then asks you to “mount the desired tape volume”. Type the number of the volume you 
choose. On a multivolume backup the recommended procedure is to mount the last through the 
first volumes, in that order. Restore checks to see if any of the requested files are on the 
mounted archive (or a later archive—thus the reverse order). If the requested files are not there, 
restore doesn’t read through the tape. If you are working with a single-volume backup or if the 
number of files being restored is large, respond to the query with 1 and restore will read the ar- 
chives in sequential order. 


t Prints the date the archive was written and the date the file system was backed up. 


The r option should only be used to restore a complete backup archive onto a clear file system, or to res- 
tore an incremental backup archive onto a file system so created. Thus: 


/etc/mkfs /dev/hd1 10000 
restore r /dev/hdl 


is a typical sequence to restore a complete backup. Another restore can be done to get an incremental 
backup in on top of this. 


ry A backup followed by a mkfs and a restore is used to change the size of a file system. 


June 28, 1985 Page 1 


RESTORE (C) RESTORE (C) 


Files 
rst* Temporary files 
/etc/default /backup Name of default archive device 


The default archive unit varies with installation. 


Notes 


It is not possible to successfully restore an entire active root file system. 


Diagnostics 


There are various diagnostics involved with reading the archive and writing the disk. There are also di- 
agnostics if the i-list or the free list of the file system is not large enough to hold the dump. 


If the dump extends over more than one disk or tape, it may ask you to change disks or tapes. Reply 
with a newline when the next unit has been mounted. 


See Also 


backup(C), dumpdir(C), fsck(C), mkfs(C) 
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Name 
Oy 


rm, rmdir — Removes files or directories. 
Syntax 

rm [ —fri | file ... 

rmdir dir ... 


Description 


Rm removes the entries for one or more files from a directory. If an entry was the last link to the file, 
the file is destroyed. Removal of a file requires write permission in its directory, but neither read nor 
write permission on the file itself. 


If a file has no write permission and the standard input is a terminal, its permissions are printed and a 
line is read from the standard input. If that line begins with y the file is deleted, otherwise the file 
remains. No questions are asked when the —f option is given or if the standard input is not a terminal. 


If a designated file is a directory, an error comment is printed unless the optional argument —r has been 
used. In that case, rm recursively deletes the entire contents of the specified directory, and the directory 
itself. 


If the —i (interactive) option is in effect, rm asks whether to delete each file, and if the —r option is in 
effect, whether to examine each directory. 


co Rmdir removes empty directories. 


See Also 


rmdir(C) 


Diagnostics 


Generally self-explanatory. It is forbidden to remove the file .. to avoid the consequences of inadver- 
tently doing something like: 


rm —r .* 
It is also forbidden to remove the root directory of a given file system. 


No more than 17 levels of subdirectories can be removed using the —r option. 
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Name 


rmdir — Removes directories. 


Syntax 
rmdir dir ... 
Description 


Rm removes the entries for one or more subdirectories from a directory. A directory must be empty 
before it can be removed. Rmdir enforces a standard and safe procedure for removing a directory; the 
contents of the directory must be removed before the directory itself can be deleted with rmdir . Note 
that the “rm -r dir” command is a more dangerous alternative to rmdir. 


Rmdir removes entries for the named directories, which must be empty. 


See Also 


rm(C) 


Notes 


Rmdir will refuse to remove the root directory of a mounted file system. 
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Name 


rmuser — Removes a user from the system. 


Syntax 


/etc /rmuser 


Description 


Rmuser removes users from the system. It begins by prompting for a user name; after receiving a valid 
user name as a response, it then deletes the named user’s entry in the password file, and removes the 
user’s mailbox file, the .profile file, and the entire home directory. It will also remove the users group 
entry in /etc/group if the user was the only remaining member of that group, and the group ID was 
greater than 50. 


Before removing a user ID from the system, make sure its mailbox is empty and that all files belonging 
to that user ID have been saved or deleted as required. 


The rmuser program will refuse to remove a user ID or any of its files if one or more of the following 
checks fails: 


— The user name given is one of the “system” user names such as root, sys, sysinfo, cron, or uucp. All 
user IDs less than 200 are considered reserved for system use, and cannot be removed using rmuser. 
Likewise all group IDs less than 50 are not removable using rmuser. 


a — The user’s mailbox exists and is not empty. 
— The user’s home directory contains files other than .profile,.cshrc, and ./ogin (for csh users). 
Rmuser can only be executed by the super-user. 
Files 
/etc/passwd 
/usr /spool/mail/username 


$HOME 


See Also 


mkuser(C), backup(C) 
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Name 


rsh — Invokes a restricted shell (command interpreter). 


Syntax 


rsh [ flags ] [ name [ arg] ... ] | 


Description 


Rsh is a restricted version of the standard command interpreter sh(C). It is used to set up login names 
and execution environments whose capabilities are more controlled than those of the standard shell. The 
actions of rsh are identical to those of sh, except that changing directory with cd, setting the value of 
$PATH, using command names containing slashes, and redirecting output using > and >> are all 
disallowed. 


When invoked with the name —rsh, rsh reads the user’s .profile (from $HOME/.profile). It acts as the 
standard sh while doing this, except that an interrupt causes an immediate exit, instead of causing a re- 
turn to command level. The restrictions above are enforced after .profile is interpreted. 


When a command to be executed is found to be a shell procedure, rsh invokes sh to execute it. Thus, it 
is possible to provide to the end user shell procedures that have access to the full power of the standard 
shell, while restricting him to a limited menu of commands; this scheme assumes that the end user does 
not have write and execute permissions in the same directory. 


The net effect of these rules is that the writer of the .profile has complete control over user actions, by 
performing guaranteed setup actions, then leaving the user in an appropriate directory (probably not the 
login directory). 


Rsh is actually just a link to sh and any flags arguments are the same as for sh(C). 


The system administrator often sets up a directory of commands that can be safely invoked by rsh. 


See Also 


sh(C), profile(M) 
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Name 


sddate — Prints and sets backup dates. 


Syntax 


sddate [ name lev date | 


Description 


If no argument is given, the contents of the backup date file “/etc/ddate” are printed. The backup date 
file is maintained by dump(C) and contains the date of the most recent backup for each backup level 
for each filesystem. 


If arguments are given, an entry is replaced or made in “/etc/ddate”. name is the last component of 
the device pathname. J/ev is the backup level number (from 0 to 9), and date is a time in the form taken 
by date(C): 


mmddhhmm|[yy] 


Where the first mm is a two-digit month in the range 01-12, dd is a two-digit day of the month, hh is a 
two-digit military hour from 00-23, and the final mm is a two-digit minute from 00-59. An optional 
two-digit year, yy, is presumed to be an offset from the year 1900, i.e., 19yy. 


Some sites may wish to back up file systems by copying them verbatim to backup media. Sddate could 
be used to make a “level 0” entry in “/etc/ddate’’, which would then allow incremental backups. 


an" For example: 
sddate rhdO 5 10081520 


makes an “/etc/ddate” entry showing a level 5 backup of “/dev/rhd0” on October 8, at 3:20 PM. 


Files 


/etc/ddate 


See Also 


dump(C), date(C) 


Diagnostics 


Illegal Date Format If the date set is syntactically incorrect. 
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Name 


sdiff — Compares files side-by-side. 


Syntax 


sdiff [ options ... ] filel file2 


Description 


Sdiff uses the output of diff(C) to produce a side-by-side listing of two files indicating those lines that 
are different. Each line of the two files is printed with a blank gutter between them if the lines are 
identical, a < in the gutter if the line only exists in file], a > in the gutter if the line only exists in 
file2, and a|for lines that are different. 


For example: 


xX | y 

a a 

b < 

c = 

d 

> Cc 
The following options exist: 
=—wW. in Uses the next argument, n, as the width of the output line. The default line length is 130 
-_ characters. 

=| Only prints the left side of any lines that are identical. 
—s Does not print identical lines. 


—o output Uses the next argument, output, as the name of a third file that is created as a user- 
controlled merging of file] and file2. Identical lines of file] and file2 are copied to output. 
Sets of differences, as produced by diff(C), are printed; where a set of differences share a 
common gutter character. After printing each set of differences, sdiff prompts the user 
with a % and waits for one of the following user-typed commands: 


1 Appends the left column to the output file 

r Appends the right column to the output file 

s Turns on silent mode; does not print identical lines 
vy Turns off silent mode 

e 1 Calls the editor with the left column 

e r Calls the editor with the right column 


e b 
Calls the editor with the concatenation of left and right 


c™ e Calls the editor with a zero length file 
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q Exits from the program 


On exit from the editor, the resulting file is concatenated on the end of the output file. 


See Also 


diff(C), ed(C) 
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Name 


sed — Invokes the stream editor. 


Syntax 


sed [ —n ] [ —e script ] [ —f sfile | [ files ] 


Description 


Sed copies the named files (standard input default) to the standard output, edited according to a script 
of commands. The —f option causes the script to be taken from file sfile; these options accumulate. If 
there is just one —e option and no —f options, the flag —e may be omitted. The —n option suppresses the 
default output. A script consists of editing commands, one per line, of the following form: 


[ address [ , address ] ] function [ arguments | 


In normal operation, sed cyclically copies a line of input into a pattern space (unless there is something 
left after a D command), applies in sequence all commands whose addresses select that pattern space, 
and at the end of the script copies the pattern space to the standard output (except under —n) and 
deletes the pattern space. 


Some of the commands use a hold space to save all or part of the pattern space for subsequent retrieval. 


An address is either a decimal number that counts input lines cumulatively across files, a $ that ad- 
dresses the last line of input, or a context address, i.e., a /regular expression/ in the style of ed(C) mo- 
a dified as follows: 


— Ina context address, the construction \?regular expression?, where ? is any character, is identical 
to /regular expression/. Note that in the context address \xabc\xdefx, the second x stands for 
itself, so that the regular expression is abcxdef. 


— The escape sequence \n matches a newline embedded in the pattern space. 

— A period . matches any character except the terminal newline of the pattern space. 

— A command line with no addresses selects every pattern space. 

— A command line with one address selects each pattern space that matches the address. 


— A command line with two addresses selects the inclusive range from the first pattern space that 
matches the first address through the next pattern space that matches the second. (If the second ad- 
dress is a number less than or equal to the line number first selected, only one line is selected.) 
Thereafter the process is repeated, looking again for the first address. 


Editing commands can be applied only to nonselected pattern spaces by use of the negation function ! 
(below). 


In the following list of functions the maximum number of permissible addresses for each function is indi- 
cated in parentheses. 


The text argument consists of one or more lines, all but the last of which end with backslashes to hide 
the newlines. Backslashes in text are treated like backslashes in the replacement string of an s com- 
mand, and may be used to protect initial blanks and tabs against the stripping that is done on every 


( , script line. The rfile or wfile argument must terminate the command line and must be preceded by ex- 
actly one blank. Each wfile is created before processing begins. There can be at most 10 distinct wfile 
arguments. 
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(1)a\ 
text 
(2)b label 
(2) e\ 
text 
(2)d 


(2)D 


(2)g 
(VG 
(2)h 
(2)H 
(1)i\ 
text 

(2)1 

(2)n 


(2)N 


(2)p 


(2)P 


(1)q 
(2)r rfile 


SED (C) 


Appends text, placing it on the output before reading the next input line. 


Branches to the : command bearing the /abel. If label is empty, branches to the end of the 
script. 


Changes text by deleting the pattern space and then appending text. With 0 or 1 address or 
at the end of a 2-address range, places text on the output and starts the next cycle. 


Deletes the pattern space and starts the next cycle. 


Deletes the initial segment of the pattern space through the first newline and starts the next 
cycle. 


Replaces the contents of the pattern space with the contents of the hold space. 
Appends the contents of the hold space to the pattern space. 
Replaces the contents of the hold space with the contents of the pattern space. 


Appends the contents of the pattern space to the hold space. 


Insert. Places text on the standard output. 


Lists the pattern space on the standard output with nonprinting characters spelled in two- 
digit ASCII and long lines folded. 


Copies the pattern space to the standard output. Replaces the pattern space with the next 
line of input. 


Appends the next line of input to the pattern space with an embedded newline. (The current 
line number changes.) 


Prints (copies) the pattern space on the standard output. 


Prints (copies) the initial segment of the pattern space through the first newline to the stan- 
dard output. 


Quits sed by branching to the end of the script. No new cycle is started. 


Reads the contents of rfile and places them on the output before reading the next input line. 


(2)s/regular expression /replacement / flags 


(2) t label 
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Substitutes the replacement string for instances of the regular expression in the pattern 
space. Any character may be used instead of /. For a more detailed description see ed(C). 
Flags is zero or more of: 


g Globally substitutes for all nonoverlapping instances of the regular expression rather 
than just the first one. 


p Prints the pattern space if a replacement was made. 


w wfile 
Writes the pattern space to wfile if a replacement was made. 


Branches to the colon (:) command bearing /abel if any substitutions have been made since 
the most recent reading of an input line or execution of a t command. If /abel is empty, t 
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ma branches to the end of the script. 
(2) w wfile Writes the pattern space to wfile. 


(2)x Exchanges the contents of the pattern and hold spaces. 


(2) y/string] /string2/ 
Replaces all occurrences of characters in string] with the corresponding characters in 
string2. The lengths of string] and string2 must be equal. 


(2)! function 
Applies the function (or group, if function is {) only to lines not selected by the address(es). 


(0): label This command does nothing; it bears a /abel for b and t commands to branch to. 


(1)= Places the current line number on the standard output as a line. 
(2){ Executes the following commands through a matching } only when the pattern space is 
selected. 
(0) An empty command is ignored. 
See Also 


awk(C), ed(C), grep(C) 
The XENIX Text Processing Guide 


cr Notes 


This command is more fully documented in the XENIX Text Processing Guide. 
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oo Name 


setmnt — Establishes /etc/mnttab table. 


Syntax 


/etc/setmnt 


Description 


Setmnt creates the /etc/mnttab table (see mnttab(F)), which is needed for both the mount(C) and 
umount(C) commands. Setmnt reads the standard input and creates a mnttab entry for each line. 
Input lines have the format: 


filesys node 


where filesys is the name of the file system’s special file (e.g., “hd0”’) and node is the root name of that 
file system. Thus filesys and node become the first two strings in the mnttab(F) entry. 


Files 


/etc/mnttab 


See Also 


_ mnttab(F) 


Notes 
If filesys or node are longer than 128 characters errors can occur. 
Setmnt silently enforces an upper limit on the maximum number of mnttab entries. 


Setmnt is normally invoked by /ete/re when the system boots up. 
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Name 


settime — Changes the access and modification dates of files. 


Syntax 


settime mmddhhmm [ yy ] [ —f fname ] name ... 


Description 


Sets the access and modification dates for one or more files. The dates are set to the specified date, or 
to the access and modification dates of the file specified via —f. Exactly one of these methods must be 
used to specify the new date(s). The first mm is the month number; dd is the day number in the month; 
hh is the hour number (24 hour system); the second mm is the minute number; yy is the last two digits 
of the year and is optional. For example: 


settime 1008004583 ralph pete 


sets the access and modification dates of files ralph and pete to Oct 8, 12:45 AM, 1983. Another ex- 
ample: 


settime —f ralph john 


This sets the access and modification dates of the file john to those of the file ralph. 


Notes 


cy 


Use of touch in place of settime is encouraged. 


June 28, 1985 Page | 


SH (C) SH (C) 


Name 


sh — Invokes the shell command interpreter. 


Syntax 


sh [ —ceiknrstuvx ] [ args | 


Description 


The shell is the standard command programming language that executes commands read from a ter- 
minal or a file. See Invocation below for the meaning of arguments to the shell. 


Commands 


A simple-command is a sequence of nonblank words separated by blanks (a blank is a tab or a space). 
The first word specifies the name of the command to be executed. Except as specified below, the remai- 
ning words are passed as arguments to the invoked command. The command name is passed as argu- 
ment 0 (see exec(S)). The value of a simple-command is its exit status if it terminates normally, or 
(octal) 1000+status if it terminates abnormally, 1.e., if the failure produces a core file. See signal(S) for 
a list of status values. 


A pipeline is a sequence of one or more commands separated by a vertical bar (|). (The caret (*) also 
has the same effect.) The standard output of each command but the last is connected by a pipe(S) to 
the standard input of the next command. Each command is run as a separate process, the shell waits for 
the last command to terminate. 


A list is a sequence of one or more pipelines separated by ;, & , & &, or |, and optionally terminated by 
: or &. Of these four symbols, ; and & have equal precedence, which is lower than that of & & and |. 
The symbols & & and || also have equal precedence. A semicolon (;) causes sequential execution of the 
preceding pipeline; an ampersand (& ) causes asynchronous execution of the preceding pipeline (i.e., the 
shell does not wait for that pipeline to finish). The symbol & & (||) causes the list following it to be 
executed only if the preceding pipeline returns a zero (nonzero) exit status. An arbitrary number of 
newlines may appear in a /ist, instead of semicolons, to delimit commands. 


A command is either a simple-command or one of the following commands. Unless otherwise stated, the 
value returned by a command is that of the last simple-command executed in the command: 


for name [ in word ... | do /ist done 
Each time a for command is executed, name is set to the next word taken from the in word list. If 
inword is omitted, then the for command executes the do /ist once for each positional parameter 
that is set (see Parameter Substitution below). Execution ends when there are no more words in 
the list. 


case word in [ pattern [ | pattern ] ...) list 3; | ... esac 
A case command executes the /ist associated with the first pattern that matches word. The form of 
the patterns is the same as that used for filename generation (see Filename Generation below). 


if Jist then list [ elif Jist then Jist | ... [ else list | fi 
The Jist following if is executed and, if it returns a zero exit status, the Jist following the first then is 
executed. Otherwise, the list following elif is executed and, if its value is zero, the Jist following the 
next then is executed. Failing that, the else /ist is executed. If no else /ist or then Jist is executed, 
ao then the if command returns a zero exit status. 
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while /ist do list done 
A while command repeatedly executes the while Jist and, if the exit status of the last command in 
the list is zero, executes the do Jist; otherwise the loop terminates. If no commands in the do Jist 
are executed, then the while command returns a zero exit Status; until may be used in place of while 
to negate the loop termination test. 


(list) 
Executes /Jist in a subshell. 


{lists} 
list is simply executed. 


The following words are recognized only as the first word of a command and when not quoted: 


if then else elif fi case esac for while until do done { } 


Comments 

A word beginning with # causes that word and all the following characters up to a newline to be ig- 
nored. A # as the first character in a file causes the file to be excuted by the C-shell /bin/csh. 

Command Substitution 

The standard output from a command enclosed in a pair of grave accents (**) may be used as part or 
all of a word; trailing newlines are removed. 

Parameter Substitution 


The character $ is used to introduce substitutable parameters. Positional parameters may be assigned 
values by set. Variables may be set by writing: 


name=value [ name=value ] ... 


Pattern-matching is not performed on value. 


${parameter} 
A parameter is a sequence of letters, digits, or underscores (a name), a digit, or any of the charac- 
ters *, @, #, ?, —, $, and !. The value, if any, of the parameter is substituted. The braces are re- 


quired only when parameter is followed by a letter, digit, or underscore that is not to be interpreted 
as part of its name. A name must begin with a letter or underscore. If parameter is a digit then it 
is a positional parameter. If parameter is * or @, then all the positional parameters, starting with 
$1, are substituted (separated by spaces). Parameter $0 is set from argument zero when the shell is 
invoked. 


${parameter:—word} 
If parameter is set and is nonnull then substitute its value; otherwise substitute word. 


${parameter:=word} 
If parameter is not set or is null, then set it to word: the value of the parameter is then substituted. 
Positional parameters may not be assigned to in this way. 


${parameter:?word} 
If parameter is set and is nonnull then substitute its value; otherwise, print word and exit from the 
shell. If word is omitted, then the message “parameter null or not set” is printed. 
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${parameter:+word} 
a If parameter is set and is nonnull then substitute word; otherwise substitute nothing. 


In the above, word is not evaluated unless it is to be used as the substituted string, so that in the fol- 
lowing example, pwd is executed only if d is not set or is null: 


echo ${d:—*pwd*} 


If the colon (:) is omitted from the above expressions, then the shell only checks whether parameter is 
set. 


The following parameters are automatically set by the shell: 

# The number of positional parameters in decimal 

— Flags supplied to the shell on invocation or by the set command 

? The decimal value returned by the last synchronously executed command 
$ The process number of this shell 

! The process number of the last background command invoked 

The following parameters are used by the shell: 


HOME 
The default argument (home directory) for the cd command 


PATH 
f \ The search path for commands (see Execution below) 


MAIL 
If this variable is set to the name of a mail file, then the shell informs the user of the arrival of mail 


in the specified file 


PS1 
Primary prompt string, by default “$ ” 


PS2 
Secondary prompt string, by default “> ” 


IFS Internal field separators, normally space, tab, and newline 


The shell gives default values to PATH, PS1, PS2, and IFS, while HOME and MAIL are not set at all by 
the shell (although HOME is set by /ogin(M)). 


Blank Interpretation 


After parameter and command substitution, the results of substitution are scanned for internal field 
separator characters (those found in IFS) and split into distinct arguments where such characters are 
found. Explicit null arguments (""or ’”) are retained. Implicit null arguments (those resulting from 
parameters that have no values) are removed. 


Filename Generation 


-_ Following substitution, each command word is scanned for the characters *, ?, and [. If one of these 
characters appears then the word is regarded as a pattern. The word is replaced with alphabetically 
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sorted filenames that match the pattern. If no filename is found that matches the pattern, then the word 
is left unchanged. The character . at the start of a filename or immediately following a /, as well as the = 
character / itself, must be matched explicitly. These characters and their matching patterns are: 


* Matches any string, including the null string. 


? Matches any single character. 


ese 
Matches any one of the enclosed characters. A pair of characters separated by — matches any 
character lexically between the pair, inclusive. If the first character following the opening bracket 
({) is an exclamation mark (!) then any character not enclosed is matched. 


Quoting 


The following characters have a special meaning to the shell and cause termination of a word unless 
quoted: 


: ee ( ) | > << > newline space. tab 


A character may be quoted (i.e., made to stand for itself) by preceding it with a \. The pair \newline is 
ignored. All characters enclosed between a pair of single quotation marks (’”), except a single quota- 
tion mark, are quoted. Inside double quotation marks (""), parameter and command substitution occurs 
and \ quotes the characters \, *, ", and $. "$*" is equivalent to "$1 $2 ...", whereas “$@” is equivalent 
LOSE SOL es 


Prompting 


When used interactively, the shell prompts with the value of PS1 before reading a command. If at any 
time a newline is typed and further input is needed to complete a command, then the secondary prompt 
(i.e., the value of PS2) is issued. 


Input/Output 


Before a command is executed, its input and output may be redirected using a special notation inter- 
preted by the shell. The following may appear anywhere in a simple-command or may precede or follow 
a command. They are not passed on to the invoked command; substitution occurs before word or digit is 


used: 

< word Use file word as standard input (file descriptor 0). 

> word Use file word as standard output (file descriptor 1). If the file does not exist then it is 
created; otherwise, it is truncated to zero length. 

>> word Use file word as standard output. If the file exists then output is appended to it (by first 


seeking the end-of-file); otherwise, the file is created. 


<<[—]|word The shell input is read up to a line that is the same as word, or to an end-of-file. The 
resulting document becomes the standard input. If any character of word is quoted, 
then no interpretation is placed upon the characters of the document; otherwise, 
parameter and command substitution occurs, (unescaped) \newline is ignored, and \ 
must be used to quote the characters \, $, *, and the first character of word. If — is ap- 
pended to <<, then all leading tabs are stripped from word and from the document. 
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< & digit The standard input is duplicated from file descriptor digit (see dup(S)). Similarly for 
in the standard output using >. 
<&—- The standard input is closed. Similarly for the standard output using >. 


If one of the above is preceded by a digit, then the file descriptor created is that specified by the digit 
(instead of the default 0 or 1). For example: 


ee eee! 
creates file descriptor 2 that is a duplicate of file descriptor 1. 


If a command is followed by & then the default standard input for the command is the empty file 
/dev/null. Otherwise, the environment for the execution of a command contains the file descriptors of 
the invoking shell as modified by input/output specifications. 


Environment 


The environment (see environ(M)) is a list of name-value pairs that is passed to an executed program in 
the same way as a normal argument list. The shell interacts with the environment in several ways. On 
invocation, the shell scans the environment and creates a parameter for each name found, giving it the 
corresponding value. Executed commands inherit the same environment. If the user modifies the values 
of these parameters or creates new ones, none of these affects the environment unless the export com- 
mand is used to bind the shell’s parameter to the environment. The environment seen by any executed 
command is thus composed of any unmodified name-value pairs originally inherited by the shell, plus 
any modifications or additions, all of which must be noted in export commands. 


co The environment for any simple-command may be augmented by prefixing it with one or more assign- 
ments to parameters. Thus: 


TERM=450 cmd args 
and 
(export TERM; TERM=450; cmd args) 
are equivalent (as far as the above execution of cmd is concerned). 


If the —k flag is set, al] keyword arguments are placed in the environment, even if they occur after the 
command name. 


Signals 


The INTERRUPT and QUIT signals for an invoked command are ignored if the command is followed by 
&; otherwise signals have the values inherited by the shell from its parent, with the exception of signal 
11 (but see also the trap command below). 


Execution 


Each time a command is executed, the above substitutions are carried out. Except for the Special Com- 
mands listed below, a new process is created and an attempt is made to execute the command via 
exec(S). 


~~ The shell parameter PATH defines the search path for the directory containing the command. Alterna- 
bd tive directory names are separated by a colon (:). The default path is :/bin:/usr/bin (specifying the 
current directory, /bin, and /usr/bin, in that order). Note that the current directory is specified by a 
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null pathname, which can appear immediately after the equal sign or between the colon delimiters 
anywhere else in the path list. If the command name contains a / then the search path is not used. 
Otherwise, each directory in the path is searched for an executable file. If the file has execute permis- 
sion but is not an a.out file, it is assumed to be a file containing shell commands. A subshell (i.e., a 
separate process) is spawned to read it. A parenthesized command is also executed in a subshell. 


Special Commands 


The following commands are executed in the shell process and, except as specified, no input/output 
redirection is permitted for such commands: 


No effect; the command does nothing. A zero exit code is returned. 


. file 
Reads and executes commands from file and returns. The search path specified by PATH is used to 
find the directory containing file. 


break [| 7n | 
Exits from the enclosing for or while loop, if any. If 7 is specified then breaks n levels. 


continue [ 7 | 
Resumes the next iteration of the enclosing for or while loop. If n is specified then resumes at the 
n-th enclosing loop. 


ed [ arg | 
Changes the current directory to arg. The shell parameter HOME is the default arg. The shell 
parameter CDPATH defines the search path for the directory containing arg. Alternative directory 
names are separated by a colon (:). The default path is <null> (specifying the current directory). 
Note that the current directory is specified by a null path name, which can appear immediately after 
the equal sign or between the colon delimiters anywhere else in the path list. If arg begins with a / 
then the search path is not used. Otherwise, each directory in the path is searched for arg. 


eval [ arg... | 
The arguments are read as input to the shell and the resulting command(s) executed. 


exec [ arg... | 
The command specified by the arguments is executed in place of this shell without creating a new 
process. Input/output arguments may appear and, if no other arguments are given, cause the shell 
input/output to be modified. 


exit [ 7 | 
Causes a shell to exit with the exit status specified by n. If n is omitted then the exit status is that 
of the last command executed (an end-of-file will also cause the shell to exit.) 


export [| name... | 
The given names are marked for automatic export to the environment of subsequently executed 
commands. If no arguments are given, a list of all names that are exported in this shell is printed. 


newgrp [ arg... | 
Equivalent to exec newgrp arg .... 


read [ name... | 
One line is read from the standard input and the first word is assigned to the first name, the second 
word to the second name, etc., with leftover words assigned to the last name. The return code is 0 
unless an end-of-file is encountered. 
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a readonly [ name ... | 


The given names are marked readonly and the values of the these names may not be changed by 
subsequent assignment. If no arguments are given, then a list of all readonly names is printed. 


set | —eknuvx [ arg... | | 
—e If the shell is noninteractive, exits immediately if a command exits with a nonzero exit status. 


—k Places all keyword arguments in the environment for a command, not just those that precede 
the command name. 


—n Reads commands but does not execute them. 
—u Treats unset variables as an error when substituting. 
—y Prints shell input lines as they are read. 


—x Prints commands and their arguments as they are executed. Although this flag is passed to sub- 
shells, it does not enable tracing in those subshells. 


—— Does not change any of the flags; useful in setting $1 to -. 


Using + rather than — causes these flags to be turned off. These flags can also be used upon invoca- 
tion of the shell. The current set of flags may be found in $—. The remaining arguments are posi- 
tional parameters and are assigned, in order, to $1, $2, ...._ If no arguments are given then the 
values of all names are printed. 


shift 
cf” The positional parameters from $2... are renamed $1.... 


test 
Evaluates conditional expressions. See test(C) for usage and description. 


times 
Prints the accumulated user and system times for processes run from the shell. 


trap [ arg | [nn]... 
arg is a command to be read and executed when the shell receives signal(s) n. (Note that arg is 


scanned once when the trap is set and once when the trap is taken.) Trap commands are executed in 
order of signal number. The highest signal number allowed is 16. Any attempt to set a trap on a 
signal that was ignored on entry to the current shell is ineffective. An attempt to trap on signal 11 
(memory fault) produces an error. If arg is absent then all trap(s) m are reset to their original 
values. If arg is the null string then this signal is ignored by the shell and by the commands it in- 
vokes. If n is 0 then the command arg is executed on exit from the shell. The trap command with 
no arguments prints a list of commands associated with each signal number. 


ulimit [ - f ] [ 7 ] 
imposes a size limit of n 


— f imposes a size limit of n blocks on files written by child processes (files of any size may be read). 
With no argument, the current limit is printed. 


If no option is given, — f is assumed. 


umask [ 000 | 
a The user file-creation mask is set to the octal number ovo where o is an octal digit (see umask(C)). 
_— If ooo is omitted, the current value of the mask is printed. 
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wait 
Waits for the specified process to terminate, and reports the termination status. If is not given 
then all currently active child processes are waited for. The return code from this command is al- 
ways 0). 


Invocation 


If the shell is invoked through exec(S) and the first character of argument 0 is —, commands are ini- 
tially read from /etc/profile and then from $HOME/.profile, if such files exist. Thereafter, commands 
are read as described below, which is also the case when the shell is invoked as /bin/sh. The flags below 
are interpreted by the shell on invocation only; note that unless the —c or —s flag is specified, the first ar- 
gument is assumed to be the name of a file containing commands, and the remaining arguments are 
passed as positional parameters to that command file: 


—c string If the —c flag is present then commands are read from string. 


—S If the —s flag is present or if no arguments remain then commands are read from the stan- 
dard input. Any remaining arguments specify the positional parameters. Shell output is 
written to file descriptor 2. 


=f If the —t flag is present then a single command is read and executed, and the shell exits. 
This flag is intended for use by C programs only and is not useful interactively. 


—i If the —i flag is present or if the shell input and output are attached to a terminal, then this 
Shell is interactive. In this case TERMINATE is ignored (so that kill 0 does not kill an in- 
teractive shell) and INTERRUPT is caught and ignored (so that wait is interruptible). In all 
cases, QUIT is ignored by the shell. 


—f If the —r flag is present the shell is a restricted shell (see rsh(C)). 
The remaining flags and arguments are described under the set command above. 
Exit Status 


Errors detected by the shell, such as syntax errors, cause the shell to return a nonzero exit status. If the 
shell is being used noninteractively then execution of the shell file is abandoned. Otherwise, the shell re- 
turns the exit status of the last command executed (see also the exit command above). 


Files 


/etc/profile 
$HOME/.profile 
/tmp/sh* 
/dev/null 


See Also 


cd(C), env(C), login(M), newgrp(C), rsh(C), test(C), umask(C), dup(S), exec(S), fork(S), pipe(S), 
signal(S), umask(S), wait(S), a.out(F), profile(M), environ(M) 
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Notes 
The command readonly (without arguments) produces the same output as the command export. 


If << is used to provide standard input to an asynchronous process invoked by &, the shell gets mixed 
up about naming the input document; a garbage file /tmp/sh* is created and the shell complains about 
not being able to find that file by another name. 
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Name 


shutdown — Terminates all processing. 


Syntax 


/etc/shutdown [ time | [ su | 


Description 


Shutdown is part of the XENIX operation procedures. Its primary function is to terminate all currently 
running processes in an orderly and cautious manner. The time argument is the number of minutes 
before a shutdown will occur; default is five minutes. The optional su argument lets the user go single- 
user, without completely shutting down the system. However, the system is shut down for multiuser use. 
Shutdown goes through the following steps. First, all users logged on the system are notified to log off 
the system by a broadcasted message. All file system super-blocks are updated before the system is 
stopped (see sync(C)). This must be done before rebooting the system, to insure file system integrity. 
See Also 


sync(C), umount(C), wall(C) 


Diagnostics 
The most common error diagnostic that will occur is device busy. This diagnostic appears when a parti- 
cular file system could not be unmounted. See umount(C). 

Notes 


Once shutdown has been invoked it must be allowed to run to completion and must not be interrupted 
by pressing BREAK or DEL. 


Shutdown does not lock the hard disk heads. 
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Name 


sleep — Suspends execution for an interval. 


Syntax 


sleep time 


Description 


Sleep suspends execution for time seconds. It is used to execute a command after a certain amount of 
time as in: 


(sleep 105; command) & 


or to execute a command every so often, as in: 


while true 
do 
command 
sleep 37 
done 


See Also 


alarm(S), sleep(S) 


Notes 


Time must be less than 65536 seconds. 
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Name 


sort — Sorts and merges files. 


Syntax 


sort [ —cmubdfinrtx ] [ +posl [ —pos2 ] ] ... [ —o output ] [ files ] 


Description 


Sort merges and sorts lines from all named files and writes the result on the standard output. A dash 
(—) may appear as a file in the files argument signifying the standard input. If no input files are 
named, the standard input is sorted. 


The default sort key is an entire line. Default ordering is lexicographic by bytes in machine collating se- 
quence. The ordering is affected globally by the following options, one or more of which may appear. 


—b Ignores leading blanks (spaces and tabs) in field comparisons. 

—d “Dictionary” order: only letters, digits and blanks are significant in comparisons. 

—f Folds uppercase letters onto lowercase. 

—i Ignores characters outside the ASCII octal range 040-0176 in nonnumeric comparisons. 


—n_ An initial numeric string, consisting of optional blanks, optional minus sign, and zero or more di- 
gits with optional decimal point, is sorted by arithmetic value. Option n implies option b. 


—r Reverses the sense of comparisons. 
—tx ‘Tab character” separating fields is x. 


_ The notation +pos1 —pos2 restricts a sort key to a field beginning at pos! and ending just before pos2. 
Pos1 and pos2 each have the form m.n, optionally followed by one or more of the flags bdfinr, where m 
tells a number of fields to skip from the beginning of the line and n tells a number of characters to skip 
further. If any flags are present they override all the global ordering options for this key. If the b op- 
tion is in effect n is counted from the first nonblank in the field; b is attached independently to pos2. A 
missing .n means .0; a missing —pos2 means the end of the line. Under the —tx option, fields are strings 
separated by x; otherwise fields are nonempty nonblank strings separated by blanks. 


When there are multiple sort keys, later keys are compared only after all earlier keys compare equal. 
Lines that otherwise compare equal are ordered with all bytes significant. Very long lines are silently 
truncated. 


These option arguments are also understood: 


—c Checks that the input file is sorted according to the ordering rules; gives no output unless the file is 
out of sort. 


—m Merges only, the input files are already sorted. 


—u Suppresses all but one in each set of duplicated lines. Ignored bytes and bytes outside keys do not 
participate in this comparison. 


—o The next argument is the name of an output file to use instead of the standard output. This file 
may be the same as one of the inputs. 
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Examples 


The following prints in alphabetical order all the unique spellings in a list of words (capitalized words 
differ from uncapitalized): 


sort —u +0f +0 list 
The following prints the password file (passwd(M)) sorted by user ID (the third colon-separated field): 
sort —t: +2n /etc/passwd 


The following prints the first instance of each month in an already sorted file of (month-day) entries (the 
options —um with just one input file make the choice of a unique representative from a set of equal lines 
predictable): 


sort —um +0 —1 dates 


Files 


/usr/tmp/stm??? 


See Also 


comm(C), join(C), uniq(C) 
Diagnostics 


Comments and exits with nonzero status for various trouble conditions and for disorder discovered under 
option —c. 
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Name 


split — Splits a file into pieces. 


Syntax 


split [ —n ] [ file [ name ] ] 


Description 
Split reads file and writes it in n-line pieces (default 1000), as many as necessary, onto a set of output 
files. The name of the first output file is name with aa appended, and so on lexicographically. If no 


output name is given, x is default. 


If no input file is given, or if a dash (—) is given instead, then the standard input file is used. 


See Also 


bfs(C), csplit(C) 
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Name 


stty — Sets the options for a terminal. 


Syntax 


stty [ —a | [ —g ] [ options ] 


Description 


Stty sets certain terminal I/O options for the device that is the current standard input; without argu- 
ments, it reports the settings of certain options; with the —a option, it reports all of the option settings; 
with the —g option, it reports current settings in a form that can be used as an argument to another sity 
command. Detailed information about the modes listed in the first five groups below may be found in 
tty(M). Options in the last group are implemented using options in the previous groups. The options are 
selected from the following: 


Control Modes 


parenb (—parenb) 
Enables (disables) parity generation and detection. 


parodd (—parodd) 
Selects odd (even) parity. 


cs5 cs6 cs7 cs8 
i Selects character size (see tty(M)). 


0 Hangs up phone line immediately. 


50 75 110 134 150 200 300 600 
1200 1800 2400 4800 9600 exta 
®Sets terminal baud rate to the number given, if possible. 


hupcl (—hupcl) 
Hangs up (does not hang up) phone connection on last close. 


hup (—hup) 
Same as hupcl (—hupcl). 


cstopb (—cstopb) 
Uses two(one) stop bits per character. 


cread (—cread) 
Enables (disables) the receiver. 


clocal (—clocal) 
Assumes a line without (with) modem control. 
Input Modes 


ignbrk (—ignbrk) 
~ Ignores (does not ignore) break on input. 
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brkint (—brkint) 
Signals (does not signal) INTR on break. 


ignpar (—ignpar) 
Ignores (does not ignore) parity errors. 


parmrk (—parmrk) 
Marks (does not mark) parity errors (see tty(M)). 


inpck (—inpck) 
Enables (disables) input parity checking. 


istrip (—istrip) 
Strips (does not strip) input characters to 7 bits. 


inlcr (—inlcr) 
Maps (does not map) NL to CR on input. 


igncr (—igncr) 
Ignores (does not ignore) CR on input. 


icrnl (—icrnl) 
Maps (does not map) CR to NL on input. 


iucle (—iuclc) 
Maps (does not map) uppercase alphabetics to lowercase on input. 


ixon (—ixon) 
Enables (disables) START/STOP output control. Output is stopped by sending an ASCII DC3 and 
started by sending an ASCII DC1. 


ixany (—ixany) 
Allows any character (only DC1) to restart output. 


ixoff (—ixoff) 
Requests that the system send (not send) START/STOP characters when the input queue is nearly 
empty/full. 

Output Modes 


opost (—opost) 
Post-processes output (does not post-process output; ignores all other output modes). 


olcuc (—olcuc) 
Maps (does not map) lowercase alphabetics to uppercase on output. 


onlcr (—onlcr) 
Maps (does not map) NL to CR-NL on output. 


ocrnl (—ocrnl) 
Maps (does not map) CR to NL on output. 


onocr (—onocr) 
Does not (does) output CRs at column zero. 


onlret (—onlret) 
On the terminal NL performs (does not perform) the CR function. 
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ofill (—ofill) 
ec’ Uses fill characters (use timing) for delays. 


ofdel (—ofdel) 
Fill characters are DELs (NULs). 


cr0 cri cr2 cr3 
Selects style of delay for carriage returns (see tty(M)). 


nl0 nll 
Selects style of delay for linefeeds (see tty(M)). 


tab0 tab1 tab2 tab3 
Selects style of delay for horizontal tabs (see tty(M)). 


bsO bs! 
Selects style of delay for backspaces (see tty(M)). 


ffO ffl 
Selects style of delay for form feeds (see tty(M)). 


vtO vtl 
Selects style of delay for vertical tabs (see tty(M)). 


Local Modes 


isig (—isig) 
co Enables (disables) the checking of characters against the special control characters INTR and QUIT. 


icanon (—icanon) 
Enables (disables) canonical input (ERASE and KILL processing). 


xcase (—xcase) 
Canonical (unprocessed) upper /lowercase presentation. 


echo (—echo) 
Echoes back (does not echo back) every character typed. 


echoe (—echoe) 
Echoes (does not echo) ERASE character as a backspace-space-backspace string. Note: this mode 
will erase the ERASEed character on many CRT terminals; however, it does not keep track of 
column position and, as a result, may be confusing on escaped characters, tabs, and backspaces. 


echok (—echok) 
Echoes (does not echo) NL after KILL character. 


Ifke (—Ifkc) 
The same as echok (—echok); obsolete. 


echonl (—echonl) 
Echoes (does not echo) NL. 


noflsh (—noflsh) 
Disables (enables) flush after INTR or QUIT. 
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Control Assignments 


control-character-C 
Sets control-character to C, where control-character is erase, kill, intr, quit, eof, eol, If C is pre- 
ceded by a caret (“) (escaped from the shell), then the value used is the corresponding CNTRL 
character (e.g., ““D” is a CNTRL-D ); ‘“*?” is interpreted as DEL and “‘*—” is interpreted as 
undefined. 


min 7, time i (0<i<127) 
When —icanon is not set, read requests are not satisfied until at least min characters have been re- 
ceived or the timeout value time has expired. See tty(C). 


line i 
Sets the line discipline to i (0 < i < 127 ). There are currently no line disciplines implemented. 
Combination Modes 


evenp or parity 
Enables parenb and cs7. 


oddp 
Enables parenb, cs7, and parodd. 


—parity, —evenp, or —oddp 
Disables parenb, and sets cs8. 


raw (—raw or cooked) 
Enables (disables) raw input and output (no ERASE, KILL, INTR, QUIT, EOT, or output post pro- 
cessing). 


nl (—nl) 
Unsets (sets) icrnl, onler. In addition —nl unsets inler, igncr, ocrnl, and onlret. 


Icase (—Icase) 
Sets (unsets) xcase, iucle, and olcuc. 


LCASE (—LCASE) 
Same as Icase (—Icase). 


tabs (—tabs or tab3) 
Preserves (expands to spaces) tabs when printing. 


ek Resets ERASE and KILL characters back to normal CNTRL-H and CNTRL-U . 


sane 
Resets all modes to some reasonable values. Useful when a terminal’s settings have been hopelessly 
scrambled. 


term 
Sets all modes suitable for the terminal type term, where term is one of tty33, tty37, vt05, tn300, 
ti700, or tek. 
See Also 


loctl(S), tty(M) 
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Notes 


Many combinations of options make no sense, but no checking is performed. 
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Name 


su — Makes the user super-user or another user. 


Syntax 


su [—] [name [arg... | ] 


Description 


Su allows you to become another user without logging off. The default user name is root (i.e., super- 
user). 


To use su, the appropriate password must be supplied (unless you are already super-user). If the 
password is correct, su executes a new shell with the user ID set to that of the specified user. To restore 
normal user ID privileges, type a CNTRL-D to the new shell. 


Any additional arguments are passed to the shell, permitting the super-user to run shell procedures with 
restricted privileges (an arg of the form —e string executes string via the shell). When additional argu- 
ments are passed, /bin/sh is always used. When no additional arguments are passed, su uses the shell 
specified in the password file. 


An initial dash (—) causes the environment to be changed to the one that would be expected if the user 
actually logged in again. This is done by invoking the shell with an arg0 of —su causing the .profile in 
the home directory of the new user ID to be executed. Otherwise, the environment is passed along with 
the possible exception of $PATH , which is set to /bin:/ete:/usr/bin for root. 


Note that .profile can check arg0 for —sh or —su to determine how it was invoked. This is true only if 
the user’s /etc/passwd entry specifies the default shell, i.e, does not explicitly specify a shell (see 
passwd(M)). 


Files 
/etc/passwd The system password file 
$HOME/.profile User’s profile 

See Also 


env(C), environ(M), login(M), passwd(M), profile(M), sh(C) 
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Name 


sum — Calculates checksum and counts blocks in a file. 


Syntax 


sum [| —r | file 


Description 


Sum calculates and prints a 16-bit checksum for the named file, and also prints the number of blocks in 
the file. It is typically used to look for bad spots, or to validate a file communicated over a transmission 
line. The option —r causes an alternate algorithm to be used in computing the checksum. 


See Also 


we(C) 


Diagnostics 


“Read error” is indistinguishable from end-of-file on most devices; check the block count. 
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Name 


sync — Updates the super-block. 


Syntax 


sync 


Description 


Sync executes the sync system primitive. If the system is to be stopped, sync must be called to ensure 
file system integrity. Note that shutdown(C) automatically calls sync before shutting down the system. 


See Also 


sync(S) 
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Name 


sysadmin — Performs file system backups and restores files. 


Syntax 


/etc/sysadmin 


Description 


Sysadmin is a script for performing file system backups and for restoring files from backup disks. It can 
do a daily incremental backup (level 9), or a periodic full backup (level 0). It can provide a listing of the 
files backed up and also has a facility to restore individual files from a backup. 


Sysadmin operates on XENIX format diskettes. The version provided backs up the root file system. The 
script can be edited to operate on additional file systems if required. 


You must be the super-user to use this program. 


Files 


/tmp/backup.list 


See Also 


o~ backup(C), restore(C), mkfs(C), dumpdir(C) 
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Name 


tail — Delivers the last part of a file. 


Syntax 


tail [ +[number] [Ibe] [ —f ] ] [ file ] 


Description 


Tail copies the named file to the standard output beginning at a designated place. If no file is named, 
the standard input is used. 


Copying begins at distance +number from the beginning, or —number from the end of the input (if 
number is null, the value 10 is assumed). Number is counted in units of lines, blocks, or characters, ac- 
cording to the appended option I, b, or ec. When no units are specified, counting is by lines. 


With the —f (“‘follow’’) option, if the input file is not a pipe, the program will not terminate after the 
line of the input file has been copied, but will enter an endless loop, wherein it sleeps for a second and 
then attempts to read and copy further records from the input file. Thus it may be used to monitor the 
growth of a file that is being written by some other process. For example, the command: 


tail —f file 


will print the last ten lines of file, followed by any lines that are appended to file between the time tail 
is initiated and killed. 


Cy 


See Also 


dd(C) 


Notes 


Tails relative to the end of the file are kept in a buffer, and thus are limited in length. Unpredictable 
results can occur if character special files are “tailed”. 
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Name 


tar — Archives files. 


Syntax 


tar [ key | [ files | 


Description 


Tar saves and restores files to and from an archive medium, which is typically a storage device such as 
floppy disk or tape, or a regular file. Its actions are controlled by the key argument. The key is a 
string of characters containing at most one function letter and possibly one or more function modifiers. 
Valid function letters are c, t, x, u, e, and r. Other arguments to the command are files (or directory 
names) specifying which files are to be backed up or restored. In all cases, appearance of a directory 
name refers to the files and (recursively) subdirectories of that directory. 


The function portion of the key is specified by one of the following letters: 
r The named files are written to the end of the archive. The c function implies this function. 


x The named files are extracted from the archive. If a named file matches a directory whose 
contents had been written onto the archive, this directory is (recursively) extracted. The 
owner, modification time, and mode are restored (if possible). If no files argument is given, the 
entire contents of the archive are extracted. Note that if several files with the same name are 
on the archive, the last one overwrites all earlier ones. 


( ) t The names of the specified files are listed each time that they occur on the archive. If no files 
argument is given, all the names on the archive are listed. 


u The named files are added to the archive if they are not already there, or if they have been 
modified since last written on that archive. 


Cc Creates a new archive; writing begins at the beginning of the archive, instead of after the last 
file. This command implies the r function. 


The following characters may be used in addition to the letter that selects the desired function: 


Q,...,7 | This modifier selects the drive on which the archive is mounted. The default is found in the file 
/etc/default/tar. 


v Normally, tar does its work silently. The v (verbose) option causes it to type the name of each 
file it treats, preceded by the function letter. With the t function, v gives more information 
about the archive entries than just the name. 


Ww Causes tar to print the action to be taken, followed by the name of the file, and then wait for 
the user’s confirmation. If a word beginning with y is given, the action is performed. Any 
other input means “no”’. 


f Causes tar to use the next argument as the name of the archive instead of the default device 
listed in /etc/default/tar. If the name of the file is a dash (—), tar writes to the standard 
output or reads from the standard input, whichever is appropriate. Thus, tar can be used as 
the head or tail of a pipeline. Tar can also be used to move hierarchies with the command: 


| cd fromdir; tar cf — .| (cd todir; tar xf —) 
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b Causes tar to use the next argument as the blocking factor for archive records. The default is 
1, the maximum is 20. This option should only be used with raw magnetic tape archives (see f 
above). The block size is determined automatically when reading tapes (key letters x and t). 


F Causes tar to use the next argument as the name of a file from which succeeding arguments 
are taken. A lone dash (—) signifies that arguments will be taken from the standard input. 


l Tells tar to print an error message if it cannot resolve all of the links to the files being backed 
up. If] is not specified, no error messages are printed. 


m Tells tar to not restore the modification times. The modification time of the file will be the 
time of extraction. 


k Causes tar to use the next argument as the size of an archive volume in kilobytes. The 
minimum value allowed is 250. This option is useful when the archive is not intended for a 
magnetic tape device, but for some fixed size device, such as floppy disk (See f above). Very 
large files are split into “extents” across volumes. When restoring from a multivolume archive, 
tar only prompts for a new volume if a split file has been partially restored. To override the 
value of k in the default file, specify k as 0 on the command line. 


e Prevents files from being split across volumes (tapes or floppy disks). If there is not enough 
room on the present volume for a given file, tar prompts for a new volume. This is only valid 
when the k option is also specified on the command line. 


n Indicates the archive device is not a magnetic tape. The k option implies this. Listing and ex- 
tracting the contents of an archive are sped because tar can seek over files it wishes to skip. 
Sizes are printed in kilobytes instead of tape blocks. 


p Indicates that files are extracted using their original permissions. It is possible that a non- 
Super-user may be unable to extract files because of the permissions associated with the files or 
directories being extracted. 


A Suppresses absolute filenames during extraction. Any leading “/’’characters are removed from 
filenames. Arguments given should match the relative (rather than the absolute) pathnames of 
the files extracted. 


Tar reads /etc/default/tar to obtain default values for the device, blocking factor and volume size. If no 
numeric key is specified on the command, tar will look for a line in the default file befinning with the 
string "archiveO=". Following this pattern are 3 blank separated strings indicating the values for the 
device, blocking factor, and volume size, in that order. A volume size of ‘0’ indicates infinite volume 
length, (the previous default value of volume) and is suitable for magnetic tape media. An example 
/etc/default/tar line follows: 


"archive0O=/dev/fd0 1 400" 


Any default value may be overridden on the command line. The numeric keys (0-7) select the line from 
the default value beginning with "archive#=", where # is the numeric key. When the f key letter is 
specified on the command line, the entry "archivef=" is used. In this case, the default file entry must 
still contain 3 strings, but the first entryt (specifying the device) is not significant. The default file 
/etc/default/tar must exist. 


Examples 
If the name of a floppy disk device is /dev/fd1, then a tar format file can be created on this device by 


typing: 
assign /dev/fd 
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tar cvfk /dev/fd1 360 files 


where files are the names of files you want archived and 360 is the capacity of the floppy disk in kilo- 
bytes. Note that arguments to key letters are given in the same order as the key letters themselves, thus 
the fk key letters have corresponding arguments /dev/fd1 and 360. Note that if a file is a directory then 
the contents of the directory are recursively archived. To print a listing of the archive, type: 


tar tvf /dev/fdl 


At some later time you will likely want to extract the files from the archive floppy. You can do this by 
typing: : 


tar xvf /dev/fdl 


The above command extracts all files from the archive using the exact same pathnames as used when 
the archive was created. Because of this behavior, it is normally best to save archive files with relative 
pathnames rather than absolute ones, since directory permissions may not let you read the files into the 
absolute directories specified. (See the A flag under Options.) 


In the above examples, the v verbose option is used simply to confirm the reading or writing of archive 
files on the screen. Also, a normal file could be substituted for the floppy device /dev/fd1 in the exam- 
ples. 

Files 


/etc/default/tar Default devices, blocking and 


volume sizes 
a. /tmp/tar* 


Diagnostics 
Prints an error message about bad key characters and archive read/write errors. 
Prints an error message if not enough memory is available to hold the link tables. 


Will not function without a valid /etc/default/tar. 


Notes 
There is no way to ask for the mth occurrence of a file. 
The u option can be slow. 


The b option should not be used with archives that are going to be updated. If the archive is on a disk 
file, the b option should not be used at all, because updating an archive stored on disk can destroy it. In 
order to update (r or u option) a tar archive, do not use raw magtape and do not use the b option. This 
applies both when updating and when the archive was first created. 


The limit on filename length is 100 characters. 


When archiving a directory that contains subdirectories, tar will only access those subdirectories that are 
within 17 levels of nesting. Subdirectories at higher levels will be ignored after tar displays an error 
message. 


Systems with a 1K-byte file system cannot specify raw disk devices unless the b option is used to specify 
an even number of blocks. This means that one cannot update a raw-mode disk partition. 
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Don’t do: 
tar xfF -— — 


This would imply taking two things from the standard input at the same time. 
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Name 


tee — Creates a tee in a pipe. 


Syntax 


tee [ —i ] [ —a ] [ file ] .. 


Description 
Tee transcribes the standard input to the standard output and makes copies in the files. The —i option 
ignores interrupts; the —a option causes the output to be appended to the files rather than overwriting 
them. 
Examples 
The following example illustrates the creation of temporary files at each stage in a pipeline: 
grep ABC | tee ABC.grep | sort | tee ABC.sort | more 


This example shows how to tee output to the terminal screen: 


grep ABC |tee /dev/tty | sort | uniq >final.file 
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Name 


test — Tests conditions. 


Syntax 


test expr 


[ expr ] 


Description 


Test evaluates the expression expr and, if its value is true, returns a zero (true) exit status; otherwise, a 
test returns a nonzero exit status if there are no arguments. The following primitives are used to con- 
Struct expr: 


—r file True if file exists and is readable. 

—w file True if file exists and is writable. 

=X file True if file exists and is executable. 

—f file True if file exists and is a regular file. 

—d file True if file exists and is a directory. 

=—¢- file True if file exists and is a character special file. 
Cy —b file True if file exists and is a block special file. 

—u file True if file exists and its set-user-ID bit is set. 

—¢g file True if file exists and its set-group-ID bit is set. 

—k file True if file exists and its sticky bit is set. 

—s file True if file exists and has a size greater than zero. 


—t [ fildes |] True if the open file whose file descriptor number is fildes (1 by default) is associated with 
a terminal device. 


= 51 True if the length of string s/J is zero. 

—n sl True if the length of the string s/ is nonzero. 
sl =s2 True if strings s/ and s2 are identical. 

sl != s2 True if strings s] and s2 are not identical. 
sl True if s/ is not the null string. 


nl —eqn2_ True if the integers n/J and n2 are algebraically equal. Any of the comparisons —ne, —gt, 
—ge, —It, and —le may be used in place of —eq. 


These primaries may be combined with the following operators: 


! Unary negation operator 
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=a Binary and operator 
—0 Binary or operator (—a has higher precedence than —o) 
( expr ) Parentheses for grouping 


Notice that all the operators and flags are separate arguments to test. Notice also that parentheses are 
meaningful to the shell and, therefore, must be escaped. 


See Also 


find(C), sh(C) 
Warning 


In the second form of the command (i.e., the one that uses [], rather than the word test), the square 
brackets must be delimited by blanks. 


June 28, 1985 Page 2 


TOUCH (C) TOUCH (C) 


Name 


touch — Updates access and modification times of a file. 


Syntax 


touch [ —amc ] [ mmddhhmm|[yy] ] files 


Description 


Touch causes the access and modification times of each argument to be updated. If no time is specified 
(see date(C)) the current time is used. The —a and —m options cause touch to update only the access or 
modification times respectively (default is —am). The —e option silently prevents touch from creating 
the file if it did not previously exist. 


The return code from touch is the number of files for which the times could not be successfully modified 
(including files that did not exist and were not created). 


See Also 


date(C), utime(S) 
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Name 


tr — Translates characters. 


Syntax 


tr [| —cds | [ string] [ string2 ] | 


Description 


Tr copies the standard input to the standard output with substitution or deletion of selected characters. 
Input characters found in string] are mapped into the corresponding characters of string2. Any com- 
bination of the options —cds may be used: 


—¢ Complements the set of characters in string] with respect to the universe of characters whose 
ASCII codes are 001 through 377 octal 


—d Deletes all input characters in string! 
=§ Squeezes all strings of repeated output characters that are in string2 to single characters 


The following abbreviation conventions may be used to introduce ranges of characters or repeated char- 
acters into the strings: 


[a—z] Stands for the string of characters whose ASCII codes run from character a to character z, in- 
clusive. 


[a*n] Stands for n repetitions of a. If the first digit of n is 0, n is considered octal; otherwise, n is 
taken to be decimal. A zero or missing n is taken to be huge; this facility is useful for padding 
string2. 


The escape character \ may be used as in the shell to remove special meaning from any character in a 
string. In addition, \ followed by 1, 2, or 3 octal digits stands for the character whose ASCII code is 
given by those digits. 


The following example creates a list of all the words in filel one per line in file2, where a word is taken 
to be a maximal string of alphabetics. The strings are quoted to protect the special characters from in- 
terpretation by the shell; 012 is the ASCII code for newline: 


tr —cs "[A—Z][a—z]" "[\012+]" <filel >file2 


See Also 


ed(C), sh(C), ascii(M) 


Notes 


Won’t handle ASCII NUL in string] or string2; always deletes NUL from input. 
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Name 


true — Returns with a zero exit value. 


Syntax 


true 


Description 


True does nothing except return with a zero exit value. False(C), true’s counterpart does nothing ex- 
cept return with a nonzero exit value. True is typically used in shell procedures such as: 


while true 
do 

command 
done 


See Also 
sh(C), false (C) 


Diagnostics 


True has exit status zero. 
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Name 


tset — Sets terminal modes. 


Syntax 


tset [ — ] [ —hrsulQS ] [| —e[c] ] [ —Efc] ] | —kIc] ] 
[ —m [ident][test baudrate|:type | [ type | 


Description 


Tset causes terminal dependent processing such as setting erase and kill characters, setting or resetting 
delays, and the like. It is driven by the /etc/ttytype and /etc/termcap files. 


The type of terminal is specified by the type argument. The type may be any type given in 
/etc/termcap. If type is not specified, the terminal type is the value of the environment variable TERM, 
unless the —h flag is set or any —m argument is given. In this case the type is read from /etc/ttytype 
(the port name to terminal type database). The port name is determined by a ttyname(S) call on the 
diagnostic output. If the port is not found in /etc/ttytype the terminal type is set to unknown. 


Ports for which the terminal type is indeterminate are identified in /etc/ttytype as dialup, plugboard, 
etc. The user can specify how these identifiers should map to an actual terminal type. The mapping 
flag, —m, is followed by the appropriate identifier (a four-character or longer substring is adequate), an 
optional test for baud rate, and the terminal type to be used if the mapping conditions are satisfied. If 
more than one mapping is specified, the first correct mapping prevails. A missing identifier matches all 
identifiers. Baud rates are specified as with stty(C), and are compared with the speed of the diagnostic 

co output. The test may be any combination of: >, =, <, @, and !. (Note: @ is a synonym for = and ! in- 
verts the sense of the test. Remember to escape characters meaningful to the shell.) 


If the type as determined above begins with a question mark, the user is asked if he really wants that 
type. A null response means to use that type; otherwise, another type can be entered which will be used 
instead. (The question mark must be escaped to prevent filename expansion by the shell.) 


Tset is most useful when included in the .login (for csh(C)) or .profile (for sh(C)) file executed automa- 
tically at login, with —m mapping used to specify the terminal type you most frequently dial in on. 


Options 


—e This flag sets the erase character to be the named character c on all terminals, so to override this 
option one can say —e#. The default for c is the backspace character on the terminal, usually 
CNTRL-H . 


—E This flag is identical to —e except that it only operates on terminals that can backspace. 


—k This option sets the kill character to the named character, c, with c defaulting to CNTRL-U. No kill 
processing is done if —k is not specified. In all of these flags, ““X’? where X is any character is 
equivalent to CNTRL-X . 


— This option prints the terminal type on the standard output; this can be used to get the terminal 
type by saying: 


set termtype = tset - 


¢ ) If no other options are given, tset operates in “fast mode” and only outputs the terminal type, 
bypassing all other processing. 
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—s This option outputs “setenv” commands (if your default shell is csh(C) or “export” and assignment 
commands (if your default shell is sh(C)); 


For the —s option with the Bourne shell, use: 


tset -s ... > /tmp/tset$$ 
/tmp/tset$$ 
rm /tmp/tset$$ 


—S This option only outputs the strings to be placed in the environment variables. 


If you are using csh, use: 
set noglob 
set term=(‘tset -S ....‘) 
setenv TERM $term[1] 
setenv TERMCAP "$term[2]" 
unset term 
unset noglob 


—r This option prints the terminal type on the diagnostic output. 

—Q This option suppresses printing the “Erase set to” and “Kill set to” messages. 

—I This option suppresses outputing the terminal initialization strings. 

ae 
This option is the mapping flag. It is used to specify the terminal type you most frequently use. It 
is followed by the appropriate identifier for your terminal, listed in /etc/ttytype . When you log on 
the system will set the terminal type to ident unless you specify otherwise. 


Examples 


tset gt42 
Sets the terminal type to gt42. 

tset —mdialup\> 300:adm3a —mdialup:dw2 —Qr —e# 
If the entry in /ete/ttytype corresponding to the login port is “dialup”, and the port speed is greater 
than 300 baud, set the terminal type to adm3a. If the /etc/ttytype entry is “dialup” and the port 


speed is less than or equal to 300 baud, set the terminal type to dw2. Set the erase character to 
“4°? and print the terminal type (but not the erase character) on standard error. 


tset —m dial:ti733 —m plug:\?hp2621 —m unknown:\? —e —k*U 


If the /etc/ttytype entry begins with “dial”, the ti733. If the entry begins with “plug’’, tset prompts 
with 


TERM = (hp2621) 


Enter the correct terminal type if it is different than that shown. If the entry is “unknown’’, tset 
prompts with 


TERM = (unknown) 
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In any case erase is set to the terminal’s backspace character, and the terminal type is printed on 
standard error. 
Files 
/etc/ttytype Port name to terminal type map database 


/etc/termcap Terminal capability database 


See Also 


tty(M), termcap(M), stty(C) 


Credit 


This utility was developed at the University of California at Berkeley and is used with permission. 
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Name 


tty — Gets the terminal’s name. 


Syntax 
tty [—s ] 
Description 


The tty command prints the pathname of the user’s terminal on the standard output. The —s option 
inhibits printing, allowing you to test just the exit code. 


Exit Codes 


0 if the standard input is a terminal, 1 otherwise. 


Diagnostics 


not a tty If the standard input is not a terminal and —s is not specified 
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Name 
ea 


umask — Sets file-creation mode mask. 


Syntax 


umask [ 000 | 


Description 


The user file-creation mode mask is set to 000. The three octal digits refer to read/write/execute per- 
missions for owner, group, and others, respectively Only the low-order 9 bits of cmask and the file mode 
creation mask are used. The value of each specified digit is “subtracted” from the corresponding “digit” 
specified by the system for the creation of any file (see umask(S) or creat(S)). This is actually a binary 
masking operation, and thus the name “umask”. In general, binary ones remove a given permission and 
zeros have no effect at all. For example, umask 022 removes group and others write permission (files 
normally created with mode 777 become mode 755 ; files created with mode 666 become mode 644). 


If ooo is omitted, the current value of the mask is printed. 


Umask is recognized and executed by the shell. By default, login shells have a umask of 022. 


See Also 


chmod(C), sh(C), chmod(S), creat(S), umask(S) 
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Name 


umount — Dismounts a file structure. 


Syntax 


/etc/umount special-device 


Description 


Umount announces to the system that the removable file structure previously mounted on device 
special-device is to be removed. Any pending I/O for the file system is completed, and the file structure 
is flagged clean. For fuller explanation of the mounting process see mount(C). 


Files 


/etc/mnttab Mount table 


See Also 


mount(C), mount(S), mnttab(F) 


Diagnostics 


device busy An executing process is using a file on the named file system 


Notes 


For the purpose of system security, this command is available only to the super user. 
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Name 


uname — Prints the current XENIX name. 


Syntax 


uname [| —snrmduva | 


Description 


Uname prints the current system name of XENIX on the standard output file. The options cause selected 
information returned by uname(S) to be printed: 


—s Prints the system name (default) 


—n Prints the nodename (the nodename may be a name that the system is known by to a communica- 
tions network) 


—r Prints the operating system release 

—m Manufacturer Prints original supplier of XENIX system 
-d_ Distributor Prints OEM for this system 

—u Prints user serial number for this system 

—y Prints the operating system version 


—a Prints all the above information 


See Also 


uname(S) 
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Name 


uniq — Reports repeated lines in a file. 


Syntax 


uniq [ —ude [ +n ] [ —n ] ] [ input [ output ] ] 


Description 


Uniq reads the input file and compares adjacent lines. In the normal case, the second and succeeding 
copies of repeated lines are removed; the remainder is written on the output file. Jnmput and output 
should always be different. Note that repeated lines must be adjacent in order to be found; see sort(C). 
If the —u flag is used, just the lines that are not repeated in the original file are output. The —d option 
specifies that one copy of just the repeated lines is to be written. The normal mode output is the union 
of the —u and —d mode outputs. 


The —c option supersedes —u and —d and generates an output report in default style but with each line 
preceded by a count of the number of times it occurred. 


The n arguments specify skipping an initial portion of each line in the comparison: 


=e The first n fields together with any blanks before each are ignored. A field is defined as a 
string of nonspace, nontab characters separated by tabs and spaces from its neighbors. 


+n The first n characters are ignored. Fields are skipped before characters. 


cy See Also 


comm(C), sort(C) 
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Name 


units — Converts units. 


Syntax 


units 


Description 


Units converts quantities expressed in various standard scales to their equivalents in other scales. It 
works interactively in this fashion: 


You have: inch 

You want: cm 
* 2.540000e+00 
/ 3.937008e—01 


A quantity is specified as a multiplicative combination of units optionally preceded by a numeric multi- 
plier. Powers are indicated by suffixed positive integers, division by the usual sign: 


You have: 15 lbs force/in2 
You want: atm 

* 1.020689e+00 

/ 9.797299e—01 


Units only does multiplicative scale changes; thus it can convert Kelvin to Rankine, but not Centigrade 


cy to Fahrenheit. Most familiar units, abbreviations, and metric prefixes are recognized, as well as the fol- 
lowing: 
pi Ratio of circumference to diameter 
c Speed of light 
e Charge on an electron 
g Acceleration of gravity 


force Same as g 

mole Avogadro’s number 

water Pressure head per unit height of water 
au Astronomical unit 


Pound is not recognized as a unit of mass; lb is. Compound names are run together, (e.g. lightyear). 
British units that differ from their US counterparts are prefixed with “br”. For a complete list of units, 


type: 


cat /usr/lib/unittab 


Files 


oO /usr/lib/unittab 
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Name 


uuclean — Clean-up the uucp spool directory. 


Syntax 


uuclean [ options ] ... 


Description 


Uuclean will scan the spool directory for files with the specified prefix and delete all those which are 
older than the specified number of hours. 


The following options are available. 


—ddirectory 
Clean directory instead of the spool directory. 


—ppre_ Scan for files with pre as the file prefix. Up to 10 —p arguments may be specified. A —p 
without any pre following will cause all files older than the specified time to be deleted. 


—ntime Files whose age is more than time hours will be deleted if the prefix test is satisfied. (default 
time is 72 hours) 


—m Send mail to the owner of the file when it is deleted. 


This program will typically be started by cron(C). 


Files 


/usr/lib/uucp directory with commands used by uuclean internally 
/usr/spool/uucp spool directory 


See Also 


uucp(C), uux(C). 
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Name 


uucp, uulog — Copies files from XENIX to XENIX. 


Syntax 
uucp [ option ] ... source-file ... destination-file 


uulog [ option | ... 


Description 


Uucp copies files named by the source-file arguments to the destination-file argument. A filename may 
be a pathname on your machine, or may have the form: 


system-name!pathname 


where “system-name” is taken from a list of system names which uucp knows about. Shell metacharac- 
ters ?*[] appearing in pathname will be expanded on the appropriate system. 


Pathnames may be a a full pathname, or a pathname preceded by “user where user is a user ID on the 
specified system and is replaced by that user’s login directory. Anything else is prefixed by the current 
directory. 


If the result is an erroneous pathname for the remote system the copy will fail. If the destination-file is 
a directory, the last part of the source-filename is used. 


Uucp preserves execute permissions across the transmission and gives 0666 read and write permissions 
(see chmod(S)). 


The following options are interpreted by uucp: 


—d Makes all necessary directories for the file copy. 
=¢ Uses the source file when copying out rather than copying the file to the spool directory. 
—m Sends mail to the requester when the copy is complete. 


Uulog maintains a summary log of uucp and wuux(CP) transactions in _ the file 
/usr/spool/uucp/LOGFILE by — gathering information from _ partial log files named 
/usr /spool/uucp/LOG.*.? . It removes the partial log files. 


The options cause uulog to print logging information: 
1316.sp100u 
—SSYS 

Prints information about work involving system sys. 
—uuser 

Prints information about work done for the specified user. 


Files 


/usr/spool/uucp Spool directory 
/usr/lib/uucp/* Other data and program files 
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See Also 


uux(C), mail(C) 


Warning 


The domain of remotely accessible files can (and for obvious security reasons, usually should) be severely 
restricted. You will very likely not be able to fetch files by pathname; ask a responsible person on the 
remote system to send them to you. For the same reasons you will probably not be able to send files to 
arbitrary pathnames. 

Notes 


For security reasons, all files received by uucp should be owned by uucp. 


The —m option will only work sending files or receiving a single file. Receiving multiple files specified by 
special shell characters ?*[] will not activate the —m option. 


This version of uucp is based on a version 7 implementation. 
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Name 


uunow — initiate a uucp connection now 


Synopsis 


uunow [ —w ] sitenamel [ —w ] [ sitenameN | 


Description 


uunow initiates a uucp(C) connection between your site and sitenames 1 through N. The command 
should normally be run in the background or you will have to wait until all spooled work (both 
machines) is disposed of. Typically wunow is invoked by cron(CP), which will automatically run uunow 
at a time specified in /usr/lib/crontab. 


If the —w option is specified, the connection will only be established if there is work for sitenameN 
spooled. Otherwise, the connection is always attempted. 


Diagnostics 


If /dev/sitenameN wire or /dev/cul0 is locked by uucp, a warning is issued. 


See Also 


uux(C), uucp(C), cron(CP) 


Notes 


There are no warnings if dialer devices other than /dev/cul0 are busy. 
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Name 


uusend — send a file to a remote host 


Synopsis 


uusend [ —m mode ] sourcefile sys1!sys2!..!remotefile 


Description 


uusend sends a file to a given location on a remote system. The system need not be directly connected 
to the local system, but a chain of uucp links needs to connect the two systems. 


If the —m option is specified, permissions of the file on the remote end will be taken from the octal 
number specified by ““mode” (see chmod(S)). Otherwise, the permissions of the input file will be used. 


The sourcefile can be “—”, meaning to use the standard input. Both of these options are primarily in- 
tended for internal use of wusend. 


The remotefile can include a tilde ( ~ ), which will expand to a user’s full pathname. 


Diagnostics 


If an error occurs on a site more than one removed from yours, you will not be notified. 


a See Also 


uux(C), uucp(C) 


Notes 


You must use wusend to send a file through systems since uucp will only copy to a designated system, 
and no further. 


All systems along the line must have the uusend command available and allow remote execution of it. 


Some uucp systems have a bug where binary files cannot be the input to a wux command. If this pro- 
blem exists in any system along the line, the file contents will be damaged. 
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Name 


uustat — Uucp status inquiry and job control. 


Syntax 


uustat [ option ] ... 


Description 


Uustat will display the status of, or cancel, previously specified wucp commands, or provide general 
status on wucp connections to other systems. The following options are recognized: 


—mmch Report the status of accessibility of machine mch. If mch is specified as all, then the status 
of all machines known to the local uucp are provided. 

—kjobn Kill the wucp request whose job number is jobn. The killed uucp request must belong to the 
person issuing the wustat command unless he is the super-user. 

—chour Remove the status entries which are older than hour hours. This administrative option can 
only be initiated by the user uucp or the super-user. 

—uuser Report the status of all wucp requests issued by user. 


—Ssys Report the status of all wucp requests which communicate with remote system sys. 


—ohour Report the status of all wucp requests which are older than hour hours. 

—yhour Report the status of all wucp requests which are younger than hour hours. 

—jall Report the status of all the wucp requests. 

—V Report the uucp status verbosely. If this option is not specified, a status code is printed with 


each uucp request. 


When no options are given, uustat outputs the status of all uucp requests issued by the current user. 
Note that only one of the options —j, —m, —k, —c may be specified at a time. 


For example, the command 
uustat -uhdc -smhtsa -y72 -v 


will print the verbose status of all wucp requests that were issued by user hdc to communicate with 
system mhtsa within the last 72 hours. The job request status format is: 


job-number user remote-system command-time status-time 


where the status may be either an octal number or a verbose description. The octal code corresponds to 
the following description: 


OCTAL STATUS 

00001 the copy failed, but the reason cannot be determined 
00002 permission to access local file is denied 
00004 permission to access remote file is denied 
00010 bad uwucp command is generated 

00020 remote system cannot create temporary file 
00040 cannot copy to remote directory 

00100 cannot copy to local directory 

00200 local system cannot create temporary file 
00400 cannot execute uucp 

01000 copy succeeded 

02000 copy finished, job deleted 

04000 job is queued 
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The machine accessibility status format is: 


system-name time status 


where time is the latest status time and status is a self-explanatory description of the machine status. 


Files 
/usr/spool /uucp spool directory 


/usr/lib/uucp/L_stat system status file 
/usr/lib/uucp/R_stat request status file 


See Also 


uucp(C). 
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Name 


uusub — Monitor uucp network. 


Syntax 


uusub [ options | 


Description 


Uusub defines a uucp subnetwork and monitors the connection and traffic among the members of the 
subnetwork. The following options are available: 


—asys Add sys to the subnetwork. 
—dsys Delete sys from the subnetwork. 


—] Report the statistics on connections. 
=F Report the statistics on traffic amount. 
a | Flush the connection statistics. 


—uhr Gather the traffic statistics over the past hr hours. 
—csys Exercise the connection to the system sys. If sys is specified as all, then exercise the connec- 
tion to all the systems in the subnetwork. 


The connections report format is: 
sys #call #ok time #dev #login #nack #other 


where sys is the remote system name, #call is the number of times the local system tries to call sys 
since the last flush was done, #ok is the number of successful connections, time is the the latest suc- 
cessful connect time, #dev is the number of unsuccessful connections because of no available device (e.g. 
ACU), #/ogin is the number of unsuccessful connections because of login failure, #nack is the number of 
unsuccessful connections because of no response (e.g. line busy, system down), and #other is the number 
of unsuccessful connections because of other reasons. 


The traffic statistics format is: 
sfile sbyte rfile rbyte 


where sfile is the number of files sent and sbyte is the number of bytes sent over the period of time indi- 
cated in the latest wusub command with the —uhr option. Similarly, rfile and rbyte are the numbers of 
files and bytes received. 


The command: 
uusub —c all —u 24 


is typically started by cron(C) once a day. 


Files 
/usr/spool/uucp/SYSLOG - system log file 
/usr/lib/uucp/L_sub connection statistics 
/usr/lib/uucp/R_sub traffic statistics 


June 28, 1985 Page 1 


Cy 


UUTO (C) UUTO (C) 


Name 


uuto, uupick — Public XENIX-to-XENIX file copy. 


Syntax 
uuto [ options ] source-files destination 
uupick [ —s system | 

Description 


Uuto sends source-files to destination. Uuto uses the uucp(CP) facility to send files, while it allows the 
local system to control the file access. A source-file name is a path name on your machine. Destination 
has the form: 


system!user 


where system is taken from a list of system names that uucp knows about (see uuname(CP)). Logname 
is the login name of someone on the specified system. 


Two options are available: 


“Dp Copy the source file into the spool directory before transmission. 
—m Send mail to the sender when the copy is complete. 


The files (or sub-trees if directories are specified) are sent to PUBDIR on system, where PUBDIR is a 
public directory defined in the wucp source. Specifically the files are sent to 


PUBDIR/receive/user/mysystem/files. 
The destined recipient is notified by mail(C) of the arrival of files. 


Uupick accepts or rejects the files transmitted to the user. Specifically, wupick searches PUBDIR for 
files destined for the user. For each entry (file or directory) found, the following message is printed on 
the standard output: 


from system: [file file-name] [dir dirname] ? 


Uupick then reads a line from the standard input to determine the disposition of the file: 


<new-line> Go on to next entry. 

d Delete the entry. 

m [ dir | Move the entry to named directory dir (current directory is default). 
a [ dir | Same as m except moving all the files sent from system. 

Pp Print the content of the file. 

q Stop. 


EOT (control-d) Same as q. 


!command Escape to the shell to do command. 
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* Print a command summary. 


Uupick invoked with the —ssystem option will only search the PUBDIR for files sent from system. 


Files 


PUBDIR /usr/spool/uucppublic public directory 


See Also 


mail(C), uuclean(C), uucp(C), uuname(C), uustat(C), uux(C). 
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Name 


uux — Executes command on remote XENIX. 


Syntax 


uux [| — ] command-string 


Description 


Uux will gather 0 or more files from various systems, execute a command on a specified system and 
send standard output to a file on a specified system. 


The command-string is made up of one or more arguments that look like a shell command line, except 
that the command and filenames may be prefixed by system-name!. A null system-name is interpreted 
as the local system. 


Filenames may be (1) a full pathname; (2) a pathname preceded by “xxx; where xxx is a user ID on the 
specified system and is replaced by that user’s login directory; or (3) anything else prefixed by the 
current directory. 


The ‘“‘—’ option will cause the standard input to the wux command to be the standard input to the 
command-string. 


For example, the command 
uux "!diff usg!/usr/dan/fl pwba!/a4/dan/fl > !fi.diff" 


will get the fl files from the usg and pwba machines, execute a diff command and put the results in 
f1.diff in the local directory. 


Any special shell characters such as <>;|should be quoted either by quoting the entire command-string, 
or quoting the special characters as individual arguments. 


Files 
/usr/uucp/spool Spool directory 


/usr/uucp/* Other data and programs 


See Also 


uucp(C) 


Warning 


An installation may, and for security reasons generally will, limit the list of commands executable on 
behalf of an incoming request from uux. Typically, a restricted site will permit little other than the re- 
ceipt of mail via uux. 


Notes 


Only the first command of a shell pipeline may have a system-name!. All other commands are executed 
on the system of the first command. 
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The shell metacharacter * will probably not perform as expected. 
The shell tokens << and >> are not implemented. 


There is no notification of denial of execution on the remote machine. 
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Name 


vi — Invokes a screen-oriented display editor. 


Syntax 


vi [ —option... | | command | | filename] 


Description 


Vi offers a powerful set of text editing operations based on a set of mnemonic commands. Most com- 
mands are single keystrokes that perform simple editing functions. Vi displays a full screen “window” 
into the file you are editing. The contents of this window can be changed quickly and easily within vi. 
While editing, visual feedback is provided (the name vi itself is short for “visual” ). 


Vi and the line editor ex are one and the same editor: the names vi and ex identify a particular user in- 
terface rather than any underlying functional difference. The differences in user interface, however, are 
quite striking. Ex is a powerful line-oriented editor, similar to the editor ed. However, in both ex and 
ed, visual updating of the terminal screen is limited, and commands are entered on a command line. Vi, 
on the other hand, is a screen-oriented editor designed so that what you see on the screen corresponds 
exactly and immediately to the contents of the file you are editing. 


Options available on the vi command line: 


=I Equivalent to an initial tag command; edits the file containing the tag and positions the 
editor at its definition. 


ed 5 Used in recovering after an editor or system crash, retrieving the last saved version of the 
named file. If no file is specified, this option prints a list of saved files. 


=| Specific to editing LISP, this option sets the showmatch and lisp options. 

—wn Sets the default window size to n. Useful on dialups to start in small windows. 

= Causes vi to prompt for a key used to encrypt and decrypt the contents of the named files. 
=—K Sets a readonly option so that files can be viewed but not edited. 


The Editing Buffer 


Vi performs no editing operations on the file that you name during invocation. Instead, it works on a 
copy of the file in an editing buffer. The editor remembers the name of the file specified at invocation, so 
that it can later copy the editing buffer back to the named file. The contents of the named file are not 
affected until the changes are copied back to the original file. This allows editing of the buffer without 
immediately destroying the contents of the original file. 


When you invoke vi with a single filename argument, the named file is copied to a temporary editing 
buffer. When the file is written out, the temporary file is written back to the named file. 

Modes of Operation 

Within vi there are three distinct modes of operation: 


Command Mode Within command mode, signals from the keyboard are interpreted as editing 
commands. 
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Insert Mode Insert mode can be entered by typing any of the vi insert, append, open, sub- 
stitute, change, or replace commands. Once in insert mode, letters typed at 

the keyboard are inserted into the editing buffer. 

Ex Escape Mode The vi and ex editors are one and the same editor differing mainly in their 
user interface. In vi commands are usually single keystrokes. In ex, com- 
mands are lines of text terminated by a RETURN. Vi has a special “‘escape”’ 
command that gives access to many of these line-oriented ex commands. To 
escape to ex escape mode, type a colon (:). The colon is echoed on the 
status line as a prompt for the ex command. An executing command can be 
aborted by pressing INTERRUPT. Most file manipulation commands are ex- 
ecuted in ex escape mode; for example, the commands to read in a file, and 
to write out the editing buffer to a file. 

Special Keys 

There are several special keys in vi. These keys are used to edit, delimit, or abort commands and com- 

mand lines. 

ESC Used to return to vi command mode, cancel partially formed commands. 

RETURN 

Terminates ex commands when in ex escape mode. Also used to start a new line when in insert 
mode. 

INTERRUPT 


Often the same as the DEL or RUBOUT key on many terminals. Generates an interrupt, telling 
the editor to stop what it is doing. Used to abort any command that is executing. 


/ Used to specify a string to be searched for. The slash appears on the status line as a prompt for 
a search string. The question mark (?) works exactly like the slash key, except that it is used 
to search backward in a file instead of forward. 


The colon is a prompt for an ex command. You can then type in any ex command, followed by 
an ESC or RETURN and the given ex command is executed. 


The following characters are special in insert mode: 


BKSP 


CNTRL-U 


CNTRL-V 


CNTRL-W 


CNTRL-T 


CNTRL-@ 
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Backs up the cursor one character on the current line. The last character typed before the 
BKSP is removed from the input buffer, but remains displayed on the screen. 


Moves the cursor back to the first character of the insertion, and restarts insertion. 


Removes the special significance of the next typed character. Use CNTRL-V to insert control 
characters. Line feed and CNTRL-J cannot be inserted in the text except as newline charac- 
ters. CNTRL-Q and CNTRL-S are trapped by the operating system before they are inter- 
preted by vi, so they too cannot be inserted as text. 


Moves the cursor back to the first character of the last inserted word. 


During an insertion, with the autoindent option set and at the beginning of the current line, 
typing this character will insert shiftwidth whitespace. 


If typed as the first character of an insertion it is replaced with the last text inserted, and the 
insertion terminates. Only 128 characters are saved from the last insertion. If more than 
128 characters were inserted, then this command inserts no characters. A CNTRL-@ cannot 
be part of a file, even if quoted. 
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Invoking and Exiting Vi 


To enter vi type: 


vl Edits empty editing buffer 

vi file Edits named file 

vi +123 file Goes to line 123 

vi +45 file Goes to line 45 

vi +/word file Finds first occurrence of “word” 
vi +/tty file Finds first occurrence of “tty” 


There are several ways to exit the editor: 
ZZ _ The editing buffer is written to the file only if any changes were made. 
‘x The editing buffer is written to the file only if any changes were made. 


-q! Cancels an editing session. The exclamation mark (!) tells vi to quit unconditionally. In this case, 
the editing buffer is not written out. 


Vi Commands 


Vi is a visual editor with a window on the file. What you see on the screen is vi’s notion of what the file 
contains. Commands do not cause any change to the screen until the complete command is typed. Most 
commands may take a preceding count that specifies repetition of the command. This count parameter 
is not given in the following command descriptions, but is implied unless overriden by some other prefix 
argument. When vi gets an improperly formatted command it rings a bell. 


Cursor Movement 


The cursor movement keys allow you to move your cursor around in a file. Note in particular the arrow 
keys (if available on your terminal), the “th” “j”, “k” , and “I” cursor keys, and SPACE, BKSP, CNTRL- 
N, and CNTRL-P. These three sets of keys perform identical functions. 


Forward Space — 1, SPACE, or --> 


Syntax: | 
SPACE 
=< 


Function: Moves the cursor forward one character. If a count is given, move forward count characters. 
You cannot move past the end of the line. 


Backspace — h, BKSP, or <-- 
Syntax: h 

BKSP 

es 


Function: Moves cursor backward one character. If a count is given, moves backward count charac- 
ters. Note that you cannot move past the beginning of the current line. 
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Next Line — +, RETURN, j, CNTRL-N, and LF 


Syntax: + 
RETURN 


Function: Moves the cursor down to the beginning of the next line. 


Syntax: j 
CNTRL-N 
LF 
(down arrow) 


Function: Moves the cursor down one line, remaining in the same column. Note the difference between 
these commands and the preceding set of next line commands which move to the beginning 
of the next line. 


Previous Line — k, CNTRL-P, and — 


Syntax: k 
CNTRL-P 
(up arrow) 


Function: Moves the cursor up one line, remaining in the same column. If a count is given then the 
cursor 1s moved count lines. 


Syntax: 


Function: Moves the cursor up to the beginning of the previous line. If a count is given then the cursor 
is moved up a count lines. 


Beginning of Line — 0 and * 


Syntax: 
0 


Function: Moves the cursor to the beginning of the current line. Note that 0 always moves the cursor 
to the first character of the current line. The caret (~) works somewhat differently: it moves 
to the first character on a line that is not a tab or a space. This is useful when editing files 
that have a great deal of indentation, such as program texts. 


End of Line — $ 
Syntax: § 


Function: Moves the cursor to the end of the current line. Note that the cursor resides on top of the 
last character on the line. If a count is given, then the cursor is moved forward count—1 
lines to the end of the line. 


Goto Line — G 
Syntax: — [linenumber]|G 


Function: Moves the cursor to the beginning of the line specified by linenumber. If no linenumber is 
given, the cursor moves to the beginning of the /ast line in the file. To find the line number 
of the current line, use CNTRL-G. 
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Column — | 
Syntax: [column] 


Function: Moves the cursor to the column in the current line given by column. If no column is given 
then the cursor is moved to the first column in the current line. 


Word Forward — w and W 


Syntax: Ww 
WwW 


Function: Moves the cursor forward to the beginning of the next word. The lowercase w command 
searches for a word defined as a string of alphanumeric characters separated by punctuation 
or whitespace (i.e., tab, newline, or space characters). The uppercase W command searches 
for a word defined as a string of nonwhitespace characters. 


Back Word — b and B 


Syntax: b 
B 


Function: Moves the cursor backward to the beginning of a word. The lowercase b command searches 
backward for a word defined as a string of alphanumeric characters separated by punctua- 
tion or whitespace (i.e., tab, newline, or space characters). The uppercase B command 
searches for a word defined as a string of non-whitespace characters. If the cursor is already 
within a word, then it moves backward to the beginning of that word. 


End — e and E 
Syntax: e 
E 


Function: Moves the cursor to the end of a word. The lowercase e command moves the cursor to the 
last character of a word, where a word is defined as a string of alphanumeric characters 
separated by punctuation or whitespace (i.e., tab, newline, or space characters). The upper- 
case E moves the cursor to the last character of a word where a word is defined as a string of 
nonwhitespace characters. If the cursor is already within a word, then it moves to the end of 
that word. 


Sentence — ( and ) 


Syntax:  ( 
) 


Function: Moves the cursor to the beginning (left parenthesis) or end of a sentence (right parenthesis). 
A sentence is defined as a sequence of characters ending with a period (.), question mark 
(2), or exclamation mark (!), followed by either two spaces or a newline. A sentence begins 
on the first nonwhitespace character following a preceding sentence. Sentences are also del- 
imited by paragraph and section delimiters. See below. 


Paragraph — { and } 


Syntax:  } 
{ 


Function: Moves the cursor to the beginning ({) or end (}) of a paragraph. A paragraph is defined 
with the paragraphs option. By default, paragraphs are delimited by the nroff macros ta. 
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“LP”, “.P”, “.QP”, and “.bp”. Paragraphs also begin after empty lines. 
Section — [[ and ]] 


Syntax: ll 
[[ 


Function: Moves the cursor to the beginning ([[) or end (]]) of a section. A section is defined with the 
sections option. By default, sections are delimited by the nroff macros “NH” and “.SH”. 
Sections also start at formfeeds (CNTRL-L) and at lines beginning with a brace ({). 


Match Delimiter — % 
Syntax: % 


Function: Moves the cursor to a matching delimiter, where a delimiter is a parenthesis, a bracket, or a 
brace. This is useful when matching pairs of nested parentheses, brackets, and braces. 


Home — H 
Syntax:  [offset]H 


Function: Moves the cursor to upper left corner of screen. Use this command to quickly move to the 
top of the screen. If an offset is given, then the cursor is homed offset-1 number of lines 
from the top of the screen. Note that the command “dH” deletes all lines from the current 
line to the top line shown on the screen. 


Middle Screen — M 
Syntax: M 


Function: Moves the cursor to the beginning of the screen’s middle line. Use this command to quickly 
move to the middle of the screen from either the top or the bottom. Note that the command 
“dM” deletes from the current line to the line specified by the M command. 


Lower Screen — L 
Syntax:  [offset]L 


Function: Moves the cursor to the lowest line on the screen. Use this command to quickly move to the 
bottom of the screen. If an offset is given, then the cursor is homed offset-1 number of lines 
from the bottom of the screen. Note that the command “dL” deletes all lines from the 
current line to the bottom line shown on the screen. 


vr 


Previous Context — “ and 


Syntax: 
“character 


‘character 


Function: Moves the cursor to previous context or to context marked with the m command. If the 
single quotation mark or back quotation mark is doubled, then the cursor is moved to pre- 
vious context. If a single character is given after either quotation mark, then the cursor is 
moved to the location of the specified mark as defined by the m command. Previous context 
is the location in the file of the last “nonrelative” cursor movement. The single quotation 
mark (") syntax is used to move to the beginning of the line representing the previous con- 
text. The back quotation mark (*) syntax is used to move to the previous context within a 
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The Screen Commands 


The screen commands are not cursor movement commands and cannot be used in delete commands as 
the delimiters of text objects. However, the screen commands do move the cursor and are useful in pa- 
ging or scrolling through a file. These commands are described below: 


Page — CNTRL-U and CNTRL-D 


Syntax: [size]JCNTRL-U 
[sizeJ CNTRL-D 


Function: Scrolls the screen up a half window (CNTRL-U) or down a half window (CNTRL-D). If size 
is given, then the scroll is size number of lines. This value is remembered for all later scrol- 
ling commands. 


Scroll — CNTRL-F and CNTRL-B 


Syntax: © CNTRL-F 
CNTRL-B 


Function: Pages screen forward and backward. Two lines of continuity are kept between pages if pos- 
sible. A preceding count gives the number of pages to move forward or backward. 


Status — CNTRL-G 


Syntax: BELL 
CNTRL-G 


Function: Prints vi status on status line. This gives you the name of the file you are editing, whether it 
has been modified, the current line number, the number of lines in the file, and the percentage 
of the file (in lines) that precedes the cursor. 


Zero Screen — Z 


Syntax: = [linenumber]|z[sizeJ]RETURN 
[/inenumber]z|size}. 
[/inenumber|z[size|— 


Function: Redraws the display with the current line placed at or “zeroed” at the top, middle, or bottom 
of the screen, respectively. If you give a size, then the number of lines displayed is equal to 
size. If a preceding linenumber is given, then the given line is placed at the top of the 
screen. If the last argument is a RETURN, then the current line is placed at the top of the 
screen. If the last argument is a period (.), then the current line is placed in the middle of 
the screen. If the last argument is a minus sign (—), then the current line is placed at the 
bottom of the screen. 


Redraw — CNTRL-R or CNTRL-L 


Syntax: CNTRL-R 
CNTRL-L 


Function: Redraws the screen. Use this command to erase any system messages that may scramble 
your screen. Note that system messages do not affect the file you are editing. 
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Text Insertion 


The text insertion commands always place you in insert mode. Exit from insert mode is always done by 
pressing ESC. The following insertion commands are “pure” insertion commands; no text is deleted 
when you use them. This differs from the text modification commands change, replace, and substitute, 
which delete and then insert text in one operation. 


Insert — i and I 


Syntax: — i[text]ESC 
I[text]ESC 


Function: Insert text in editing buffer. The lowercase i command places you in insert mode. Text is 
inserted before the character beneath the cursor. To insert a newline, just press a RETURN. 
Exit insert mode by typing the ESC key. The uppercase I command places you in insert 
mode, but begins text insertion at the beginning of the current line, rather than before the 
cursor. 


Append — a and A 


Syntax:  al[text]ESC 
A[text]ESC 


Function: Appends text to the editing buffer. The lowercase a command works exactly like the lower- 
case i command, except that text insertion begins after the cursor and not before. This is the 
one way to add text to the end of a line. The uppercase A command begins appending text 
at the end of the current line rather than after the cursor. 


Open New Line — o and O 


Syntax:  oftext]ESC 
O[text]ESC 


Function: Opens a new line and inserts text. The lowercase 0 command opens a new line below the 
current line; uppercase O opens a new line above the current line. After the new line has 
been opened, both these commands work like the I command. 


Text Deletion 


Many of the text deletion commands use the letter “d’’ as an operator. This operator deletes text ob- 
jects delimited by the cursor and a cursor movement command. Deleted text is always saved away in a 
buffer. The delete commands are described below: 


Delete Character — x and X 


Syntax: x 
X 


Function: Deletes a character. The lowercase x command deletes the character beneath the cursor. 
With a preceding count, count characters are deleted to the right beginning with the 
character beneath the cursor. This is a quick and easy way to delete a few characters. The 
uppercase X command deletes the character just before the cursor. With a preceding count, 
count characters are deleted backward, beginning with the character just before the cursor. 


Delete — d and D 
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Syntax: | dcursor-movement 
dd 
D 


Function: Deletes a text object. The lowercase d command takes a cursor-movement as an argument. 
If the cursor-movement is an intraline command, then deletion takes place from the cursor to 
the end of the text object delimited by the cursor-movement . Deletion forward deletes the 
character beneath the cursor; deletion backward does not. If the cursor-movement is a mul- 
tiline command, then deletion takes place from and including the current line to the text ob- 
ject delimited by the cursor-movement . 


The dd command deletes whole lines. The uppercase D command deletes from and including the cursor 
to the end of the current line. 


Deleted text is automatically pushed on a stack of buffers numbered 1 through 9. The most recently 
deleted text is also placed in a special delete buffer that is logically buffer 0. This special buffer is the 
default buffer for all (put) commands using the double quotation mark (") to specify the number of the 
buffer for delete, put, and yank commands. The buffers 1 through 9 can be accessed with the p and P 
(put) commands by appending the double quotation mark (") to the number of the buffer. For example 


"4p 


puts the contents of delete buffer number 4 in your editing buffer just below the current line. Note that 
the last deleted text is “put” by default and does not need a preceding buffer number. 


Text Modification 


The text modification commands all involve the replacement of text with other text. This means that 
some text will necessarily be deleted. All text modification commands can be “undone” with the u com- 
mand, discussed below: 


Undo — u and U 
Syntax: u 
U 


Function: Undoes the last insert or delete command. The lowercase u command undoes the last insert 
or delete command. This means that after an insert, u deletes text; and after a delete, u in- 
serts text. For the purposes of undo, all text modification commands are considered inser- 
tions. 


The uppercase U command restores the current line to its state before it was edited, no 
matter how many times the current line has been edited since you moved to it. 


Repeat — . 
Syntax: ‘ 


Function: Repeats the last insert or delete command. A special case exists for repeating the p and P 
“nut” commands. When these commands are preceded by the name of a delete buffer, then 
successive u commands print out the contents of the delete buffers. 


Change — c and C 


Syntax: ccursor-movement textESC 
CtextESC 
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Function: 


FFI) 


cctextESC 


Changes a text object and replaces it with text . Text is inserted as with the i command. A 
dollar sign ($) marks the extent of the change. The ec command changes arbitrary text ob- 
jects delimited by the cursor and a cursor-movement . The C and ce commands affect whole 
lines and are identical in function. 


Replace — r and R 


Syntax: 


Function: 


rchar 
RtextESC 


Overstrikes character or line with char or text , respectively. Use r to overstrike a single 
character and R to overstrike a whole line. A count multiplies the replacement text count 
times. 


Substitute — s and S 


Syntax: 


Function: 


Filter — ! 
Syntax: 


Function: 


stextESC 
StextESC 


Substitutes current character or current line with text. Use s to replace a single character 
with new text. Use S to replace the current line with new text. If a preceding count is 
given, then text substitutes for count number of characters or lines depending on whether the 
command is s or S, respectively. 


!cursor-movement cmdRETURN 


Filters the text object delimited by the cursor and cursor-movement through the KENIX 
command, cmd. For example, the following command sorts all lines between the cursor and 
the bottom of the screen, substituting the designated lines with the sorted lines: 


'Lsort 


Arguments and shell metacharacters may be included as part of cmd; however, standard 
input and output are always associated with the text object being filtered. 


Join Lines — J 


Syntax: 


Function: 


J 


Joins the current line with the following line. If a count is given, then count lines are joined. 


Shift — < and > 


Syntax: 


Function: 
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> [cursor-movement] 
<[cursor-movement| 
> 
—% 


Shifts text left (>) or right (<). Text is shifted by the value of the option shiftwidth, 
which is normally set to eight spaces. Both the > and < commands shift all lines in the 
text object delimited by the current line and cursor-movement. The >> and << com- 
mands affect whole lines. All versions of the command can take a preceding count that acts 
to multiply the number of objects affected. 
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Text Movement 


The text movement commands move text in and out of the named buffers a-z and out of the delete 
buffers 1-9. These commands either “yank” text out of the editing buffer and into a named buffer or 
“put” text into the editing buffer from a named buffer or a delete buffer. By default, text is put and 
yanked from the “unnamed buffer”, which is also where the most recently deleted text is placed. Thus 
it is quite reasonable to delete text, move your cursor to the location where you want the deleted text 
placed, and then put the text back into the editing buffer at this new location with the p or P command. 


The named buffers are most useful for keeping track of several chunks of text that you want to keep on 
hand for later access, movement, or rearrangement. These buffers are named with the letters “a” 
through ‘“z’’. To refer to one of these buffers (or one of the numbered delete buffers) in a command 


such as put, yank, or delete, use a quotation mark. For example, to yank a line into the buffer named a, 
type: 


To put this text back into the file, type: 


ap 
If you delete text into the buffer named 4 rather than a, then text is appended to the buffer. 


Note that the contents of the named buffers are not destroyed when you switch files. Therefore, you can 
delete or yank text into a buffer, switch files, and then do a put. Buffer contents are destroyed when you 
exit the editor, so be careful. 


Put — p and P 


Syntax: = ["alphanumeric]p 
["alphanumeric|P 


Function: Puts text from a buffer into the editing buffer. If no buffer name is specified, then text is 
put from the unnamed buffer. The lowercase p command puts text either below the current 
line or after the cursor, depending on whether the buffer contains a partial line or not. The 
uppercase P command puts text either above the current line or before the cursor, again 
depending on whether the buffer contains a partial line or not. 


Yank — y and Y 

Syntax: — ["letter]ycursor-movement 
["Jetterlyy 
["Jetter]Y 


Function: Copies text in the editing buffer to a named buffer. If no buffer name is specified, then text 
is yanked into the unnamed buffer. If an uppercase /etter is used, then text is appended to 
the buffer and does not overwrite and destroy the previous contents. When a cursor- 
movement is given as an argument, the delimited text object is yanked. The Y and yy com- 
mands yank a single line, or, if a preceding count is given, multiple lines can be yanked. 


Searching 


The search commands search either forward or backward in the editing buffer for text that matches a 
given regular expression. 
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Search — / and ? 


Syntax: 


Function: 


/|pattern]/[offset]RETURN 
/|patternJRETURN 
?[pattern]?[offset]RETURN 
?[patternJRETURN 


Searches forward (/) or backward (?) for pattern. A string is actually a regular expression. 
The trailing delimiter is not required. If no pattern is given, then last pattern searched for is 
used. After the second delimiter, an offset may be given, specifying the beginning of a line 
relative to the line on which pattern was found. For example 


/word /- 
finds the beginning of the line immediately preceding the line containing “word” and 
/word/+2 


finds the beginning of the line two lines after the line containing “‘word’’. See also the ig- 
norecase and magic options. 


Next String — n and N 


Syntax: 


Function: 


n 
N 


Repeats the last search command. The n command repeats the search in the same direction 
as the last search command. The N command repeats the search in the opposite direction of 
the last search command. 


Find Character — f and F 


Syntax: 


Function: 


fchar 
Fchar 


b] 


Finds character char on the current line. The lowercase f searches forward on the line; the 
uppercase F searches backward. The semicolon (;) repeats the last character search. The 
comma (,) reverses the direction of the search. 


To Character — t and T 


Syntax: 


Function: 
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tchar 
Tchar 


9 


9 


Moves the cursor up to but not on to char. The semicolon (;) repeats the last character 
search. The comma (,) reverses the direction of the search. 
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Mark — m 


-_ Syntax: miletter 


Function: Marks a place in the file with a lowercase Jetter. You can move to a mark using the “to 
mark”? commands described below. It is often useful to create a mark, move the cursor, and 
then delete from the cursor to the mark “‘a” with the following command: 


d‘a 
To Mark — and - 


Syntax: ‘letter 
‘letter 


Function: Move to /etter. These commands let you move to the location of a mark. Marks are 
denoted by single lowercase alphabetic characters. Before you can move to a mark, it must 
first be created with the m command. The back quotation mark (‘) moves you to the exact 
location of the mark within a line; the forward quotation mark (") moves you to the begin- 
ning of the line containing the mark. Note that these commands are also legal cursor move- 
ment commands. 


Exit and Escape Commands 


There are several commands that are used to escape from vi command mode and to exit the editor. 
These are described below: 


Ex Escape — : 
Syntax: 


Function: Enters ex escape mode to execute an ex command. The colon appears on the status line as a 
prompt for an ex command. You then can enter an ex command line terminated by either a 
RETURN or an ESC and the ex command will execute. You are then prompted to type RE- 
TURN to return to vi command mode. During the input of the ex command line or during 
execution of the ex command you may press INTERRUPT to abort what you are doing and 
return to vi command mode. 


Exit Editor — ZZ 
Syntax: ZZ 


Function: Exit vi and write out the file if any changes have been made. This returns you to the shell 
from which you invoked vi. 


Quit to Ex — Q 
Syntax: Q 
Function: Enters the ex editor. When you do this, you will still be editing the same file. You can re- 
turn to vi by typing the vi command from ex. 
Ex Commands 


Typing the colon (:) escape command when in command mode, produces a colon prompt on the status 
) line. This prompt is for a command available in the line-oriented editor, ex. In general, ex commands 
let you write out or read in files, escape to the shell, or switch editing files. 
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Many of these commands perform actions that affect the “current” file by default. The current file is 
normally the file that you named when you invoked vi, although the current file can be changed with the 
“file” command, f, or with the “next” command, n. In most respects, these commands are identical to 
similar commands for the editor, ed. All such ex commands are aborted by either a RETURN or an 
ESC. We shall use a RETURN in our examples. Command entry is terminated by typing an 
INTERRUPT. 


Command Structure 


Most ex command names are English words, and initial prefixes of the words are acceptable abbrevia- 
tions. In descriptions, only the abbreviation is discussed, since this is the most frequently used form of 
the command. The ambiguity of abbreviations is resolved in favor of the more commonly used com- 
mands. As an example, the command substitute can be abbreviated s while the shortest available abbre- 
viation for the set command is se. 


Most commands accept prefix addresses specifying the lines in the file that they are to affect. A number 
of commands also may take a trailing count specifying the number of lines to be involved in the com- 
mand. Counts are rounded down if necessary. Thus, the command “10p” will print the tenth line in the 
buffer while “move 5” will move the current line after line 5. 


Some commands take other information or parameters, stated after the command name. Examples 
might be option names in a set command, such as “set number”, a filename in an edit command, a re- 
gular expression in a substitute command, or a target address for a copy command, such as 


lo copy 25 


A number of commands have variants. The variant form of the command is invoked by placing an ex- 
clamation mark (!) immediately after the command name. Some of the default variants may be con- 
trolled by options; in this case, the exclamation mark turns off the meaning of the default. 


6699 


In addition, many commands take flags, including the characters “p” and “lI”. A “p” or “I” must be 
preceded by a blank or tab. In this case, the command abbreviated by these characters is executed after 
the command completes. Since ex normally prints the new current line after each change, p is rarely 
necessary. Any number of plus (+) or minus (—) characters may also be given with these flags. If they 
appear, the specified offset is applied to the current line value before the printing command is executed. 


Most commands that change the contents of the editor buffer give feedback if the scope of the change 
exceeds a threshold given by the report option. This feedback helps to detect undesirably large changes 
so that they may be quickly and easily reversed with the undo command. After commands with global 
effect, you will be informed if the net change in the number of lines in the buffer during this command 
exceeds this threshold. 


Command Addressing 


The following specifies the line addressing syntax for ex commands: 


The current line. Most commands leave the current line as the last line which they 
affect. The default address for most commands is the current line, thus “.” is rarely 
used alone as an address. 


n The nth line in the editor’s buffer, lines being numbered sequentially from 1. 
$ The last line in the buffer. 
% An abbreviation for “1,$”, the entire buffer. 
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+n or —n An offset, 1 relative to the current buffer line. The forms “.+3” “+3” and “+++” are 
all equivalent. If the current line is line 100 they all address line 103. 


/pattern/ or ?pattern? 

Scan forward and backward respectively for a text matching the regular expression 
given by pattern. Scans normally wrap around the end of the buffer. If all that is 
desired is to print the next line containing pattern, then the trailing slash (/) or ques- 
tion mark (?) may be omitted. If pattern is omitted or explicitly empty, then the 
string matching the last specified regular expression is located. The forms “RETURN” 
and “?RETURN” scan using the last named regular expression. After a substitute, 
“RETURN” and “??RETURN” would scan using that substitute’s regular expression. 


or x Before each nonrelative motion of the current line dot (.), the previous current line is 
marked with a label, subsequently referred to with two single quotation marks ("). 
This makes it easy to refer or return to this previous context. Marks are established 
with the vi m command, using a single lowercase letter as the name of the mark. 
Marked lines are later referred to with the notation 


| A 


As 


where x is the name of a mark. 


Addresses to commands consist of a series of addresses, separated by a colon (,) or a semicolon (;). 
Such address lists are evaluated left to right. When addresses are separated by a semicolon (;) the 
current line (.) is set to the value of the previous addressing expression before the next address is inter- 
preted. If more addresses are given than the command requires, then all but the last one or two are ig- 
nored. If the command takes two addresses, the first addressed line must precede the second in the 
buffer. Null address specifications are permitted in a list of addresses, the default in this case is the 
current line “‘.”; thus “,100” is equivalent to ‘.,100”. It is an error to give a prefix address to a com- 
mand which expects none. 


Command Format 


The following is the format for all ex commands: 


[address| [command] {!] [parameters] [count] [flags| 


All parts are optional depending on the particular command and its options. The following section 
describes specific commands. 


Argument List Commands 


The argument list commands allow you to work on a set of files, by remembering the list of filenames 
that are specified when you invoke v1. The args command lets you examine this list of filenames. The 
file command gives you information about the current file. The n (next) command lets you either edit 
the next file in the argument list or change the list. And the rewind command lets you restart editing 
the files in the list. All of these commands are described below: 


args The members of the argument list are printed, with the current argument delimited by 
brackets. For example, a list might look like this: 


filel file2 [file3] file4 fileS 


The current file is file3. 
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Prints the current filename, whether it has been modified since the last write command, 
whether it is readonly, the current linenumber, the number of lines in the buffer, and 
the percentage of the buffer that you have edited. In the rare case that the current file 
is “[Not edited]” this is noted also; in this case you have to use the form ‘“‘w!” to write 
to the file, since the editor is not sure that a w command will not destroy a file unrelated 
to the current contents of the buffer. 


The current filename is changed to file which is considered “‘[Not edited]”’. 
The next file in the command line argument list is edited. 


This variant suppresses warnings about the modifications to the buffer not having been 
written out, discarding irretrievably any changes that may have been made. 


n [+command] filelist 


rew 


rew! 


The specified fi/elist is expanded and the resulting list replaces the current argument 
list; the first file in the new list is then edited. If command is given (it must contain no 
spaces), then it is executed after editing the first such file. 


The argument list is rewound, and the first file in the list is edited. 


Rewinds the argument list discarding any changes made to the current buffer. 


Edit Commands 


To edit a file other than the one you are currently editing, you will often use one of the variations of the 
e command. 


In the following discussions, note that the name of the current file is always remembered by vi and is 
specified by a percent sign (%). The name of the previous file in the editing buffer is specified by a 
number sign (#). 


The edit commands are described below: 


e file 


e! file 


e +n file 


CNTRL-* 


June 28, 1985 


Used to begin an editing session on a new file. The editor first checks to see if the buffer has 
been modified since the last w command was issued. If it has been, a warning is issued and 
the command is aborted. The command otherwise deletes the entire contents of the editor 
buffer, makes the named file the current file and prints the new filename. After ensuring 
that this file is sensible, (i.e., that it is not a binary file, directory, or a device), the editor 
reads the file into its buffer. If the read of the file completes without error, the number of 
lines and characters read is printed on the status line. If there were any non—ASCII charac- 
ters in the file they are stripped of their non—ASCII high bits, and any null characters in the 
file are discarded. If none of these errors occurred, the file is considered edited. If the last 
line of the input file is missing the trailing newline character, it is supplied and a complaint 
issued. The current line is initially the first line of the file. 


This variant form suppresses the complaint about modifications having been made and not 
written from the editor buffer, thus discarding all changes that have been made before edi- 
ting the new file. 


Causes the editor to begin editing at line m rather than at the first line. The argument n 
may also be an editor command containing no spaces; for example, “+/pattern”. 


This is a shorthand equivalent for “:e #RETURN”, which returns to the previous position in 
the last edited file. If you do not want to write the file you should use “:e! #RETURN” 
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instead. 


Write Commands 


The write commands let you write out all or part of your editing buffer to either the current file or to 
some other file. These commands are described below: 


w file 
Writes changes made back to file, printing the number of lines and characters written. Normally, 
file is omitted and the buffer is written to the name of the current file. If file is specified, then text 
will be written to that file. The editor writes to a file only if it is the current file and is edited, or if 
the file does not exist. Otherwise, you must give the variant form w! to force the write. If the file 
does not exist it is created. The current filename is changed only if there is no current filename; the 
current line is never changed. 


If an error occurs while writing the current and edited file, the editor prints 
No write since last change 


even if the buffer had not previously been modified. 


w>> file 
Appends the buffer contents at the end of an existing file. Previous file contents are not destroyed. 


w! name 
Overrides the checking of the normal write command, and writes to any file that the system permits. 


w !command 
Writes the specified lines into command. Note the difference between 


w! file 
which overrides checks and 
w !cmd 


which writes to a command. The output of this command is displayed on the screen and not in- 
serted in the editing buffer. 


Read Commands 


The read commands let you read text into your editing buffer at any location you specify. The text you 
read in must be at least one line long, and can be either a file or the output from a command. 


r file Places a copy of the text of the given file in the editing buffer after the specified line. If no 
file is given then the current filename is used. The current filename is not changed unless 
there is none, in which case the file becomes the current name. If the file buffer is empty 
and there is no current name then this is treated as an e command. 


Address 0 is legal for this command and causes the file to be read at the beginning of the 
buffer. Statistics are given as for the e command when the r successfully terminates. After 
an r the current line is the last line read. 


r !command 
Reads the output of command into the buffer after the specified line. A blank or tab before 
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the exclamation mark (!) is mandatory. 


Quit Commands 


There are several ways to exit vi. Some abort the editing session, some write out the editing buffer 
before exiting, and some warn you if you decide to exit without writing out the buffer. All of these ways 
of exiting are described below: 


q 


q! 
wq name 


wq! name 


X hame 


Exits vi. No automatic write of the editor buffer to a file is performed. However, vi issues a 
warning message if the file has changed since the last w command was issued, and does not 
quit. Vi will also issue a diagnostic if there are more files in the argument list left to edit. 
Normally, you will wish to save your changes, and you should give a w command. If you 
wish to discard them, use the “q!’’ command variant. 


Quits from the editor, discarding changes to the buffer without complaint. 
Like a w and then a q command. 


This variant overrides checking of the w command so that you can write to file that the 
system allows. 


If any changes have been made and not written, writes the buffer out and then quits. Oth- 
erwise, it just quits. 


Global and Substitute Commands 


The global and substitute commands allow you to perform complex changes to a file in a single com- 
mand. Learning how to use these commands is a must for the serious user of vi. 


g/pattern/cmds 


g/s1/p 


The g command has two distinct phases. In the first phase, each line matching pattern in 
the editing buffer is marked. Next, the given command list is executed with the current line, 
dot (.), initially set to each marked line. 


The command list consists of the remaining commands on the current input line and may 
continue to multiple lines by ending all but the last such line with a backslash (\). This 
multiple-line option will not work from within vi, you must switch to ex to do it. If cmds (or 
the trailing slash (/) delimiter) is omitted, then each line matching pattern is printed. 


The g command itself may not appear in cmds. The options autoprint and autoindent are 
inhibited during a global command and the value of the report option is temporarily infinite, 
in deference to a report for the entire global. Finally, the context mark (’) or (°) is set to 
the value of the current line (.) before the global command begins and is not changed during 
a global command. 


The following global commands, most of them substitutions, cover the most frequent uses of 
the global command. 


This command simply prints all lines that contain the string “sl” . 


g/s1/s//s2/ This command substitutes the first occurrence of “sl” on all lines that contain it with 


the string “‘s2”’. 


g/sl/s//s2/g | This command substitutes all occurrences of “‘s1”’ with the string “‘s2”. This includes 
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multiple occurrences of “‘s1” on a line. 
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g/sl/s//s2/gp 


g/s1/s//s2/ge 


g/s0/s/s1 /s2/e 


VI (C) 


This command works the same as the preceding example, except that in addition, all 
changed lines are printed on the screen. 


This command asks you to confirm that you want to make each substitution of the 
string “sl” with the string ‘“‘s2”. If you type a “y” then the given substitution is made, 
otherwise it is not. 


This command marks all those lines that contain the string “sO”, and then for those 
lines only, it substitutes all occurrences of the string “sl” with “s2”. 


g!/pattern/cmds This variant form of g runs cmds at each line not matching pattern. 


s/pattern/repl/options 


v/pattern/cmds 


On each specified line, the first instance of text matching the regular expression pattern 
is replaced by the replacement text rep/. If the global indicator option character “g” 
appears, then all instances on a line are substituted. If the confirm indication 
character “‘c” appears, then before each substitution the line to be substituted is 
printed on the screen with the string to be substituted marked with caret (~) charac- 
ters. By typing a “y”, you cause the substitution to be performed; any other input 
causes no change to take place. After an s command the current line is the last line 


substituted. 


A synonym for the global command variant g!, running the specified cmds on each line 
that does not match pattern. 


Text Movement Commands 


The text movement commands are largely superseded by commands available in vi command mode. 
However, the following two commands are still quite useful. 


co addr flags 


[range|maddr 


A copy of the specified lines is placed after addr, which may be “0” . The current line 
‘*”? addresses the last line of the copy. 


The m command moves the lines specified by range after the line given by addr. For 
example, “m+” swaps the current line and the following line, since the default range is 
just the current line. The first of the moved lines becomes the current line (dot). 


Shell Escape Commands 


You will often want to escape from the editor to execute normal XENIX commands. You may also want 
to change your working directory so that your editing can be done with respect to a different working 
directory. These operations are described below: 


cd directory 


sh 


!command 
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The specified directory becomes the current directory. If no directory is specified, the 
current value of the home option is used as the target directory. After a cd the current 
file is not considered to have been edited so that write restrictions on preexisting files 
still apply. 


A new shell is created. You may invoke as many commands as you like in this shell. 
To return to vi, type a CNTRL-D to terminate the shell. 


The remainder of the line after the exclamation (!) is sent to a shell to be executed. 
Within the text of command the characters “%” and “#” are expanded as the 
filenames of the current file and the last edited file and the character “!” is replaced 
with the text of the previous command. Thus, in particular, “!! repeats the last such 
shell escape. If any such expansion is performed, the expanded line is echoed. The 
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current line is unchanged by this command. 


If there has been “[No write]” of the buffer contents since the last change to the editing buffer, then a 
diagnostic is printed before the command is executed as a warning. A single exclamation (!) is printed 
when the command completes. 


Other Commands 


The following command descriptions explain how to use miscellaneous ex commands that do not fit into 
the above categories: 


abbr Maps the first argument to the following string. For example, the following command 
:abbr rainbow yellow green blue red 


maps “rainbow” to “yellow green blue red”. Abbreviations can be turned off with the unab- 
breviate command, as in: 


‘una rainbow 


map, map! Maps any character or escape sequence to an existing command sequence. Characters 
mapped with map! work only in insert mode, while characters mapped with map work only in 
command mode. 


nu Prints each specified line preceded by its buffer line number. The current line is left at the 
last line printed. To get automatic line numbering of lines in the buffer, set the number op- 
tion. 


preserve The current editor buffer is saved as though the system had just crashed. This command is 
for use only in emergencies when a w command has resulted in an error and you don’t know 
how to save your work. 


= Prints the line number of the addressed line. The current line is unchanged. 


recover file 
Recovers file from the system save area. The system saves a copy of the editing buffer only 
if you have made changes to the file, the system crashes, or you execute a preserve command. 
Except when you use preserve you will be notified by mail when a file is saved. 


set argument 
With no arguments, set prints those options whose values have been changed from their de- 
faults; with the argument a/l it prints all of the option values. 


Giving an option name followed by a question mark (?) causes the current value of that option to be 
printed. The “?” is unnecessary unless the option is Boolean valued. Switch options are given values 
either with 

set option 
to turn them on or 

set nooption 


to turn them off. String and numeric options are assigned with 


set option=value 
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More than one parameter may be given to set; all are interpreted from left to right. 


tag label 
The focus of editing switches to the location of /abel. If necessary, vi will switch to a different file 
in the current directory to find /abel. If you have modified the current file before giving a tag com- 
mand, you must first write it out. If you give another tag command with no argument, then the pre- 
vious /abel is used. 


Similarly, if you type only a CNTRL-], vi searches for the word immediately after the cursor as a 
tag. This is equivalent to typing “:tag”, this word, and then a RETURN. 


The tags file is normally created by a program such as ctags, and consists of a number of lines with 
three fields separated by blanks or tabs. The first field gives the name of the tag, the second the 
name of the file where the tag resides, and the third gives an addressing form which can be used by 
the editor to find the tag. This field is usually a contextual scan using /pattern/ to be immune to 
minor changes in the file. Such scans are always performed as if the nomagic option was set. The 
tag names in the tags file must be sorted alphabetically. There are a number of options that can be 
set to affect the vi environment. These can be set with the ex set command either while editing or 
immediately after vi is invoked in the vi start-up file, .exrc. 


The first thing that must be done before you can use vi, is to set the terminal type so that vi understands 
how to talk to the particular terminal you are using. 


Each time vi is invoked, it reads commands from the file named .exrc in your home directory. This file 
normally sets the user’s preferred options so that they need not be set manually each time you invoke vi. 
Each of the options is described in detail below. 


Options 


There are only two kinds of options: switch options and string options. A switch option is either on or 
off. A switch is turned off by prefixing the word no to the name of the switch within a set command. 
String options are strings of characters that are assigned values with the syntax option=string. Multiple 
options may be specified on a line. Vi options are listed below: 


autoindent, ai default: noai 
Can be used to ease the preparation of structured program text. For each line created by an ap- 
pend, change, insert, open, or substitute operation, vi looks at the preceding line to determine and 
insert an appropriate amount of indentation. To back the cursor up to the preceding tab stop, you 
can type CNTRL-D. The tab stops going backward are defined as multiples of the shiftwidth option. 
You cannot backspace over the indent, except by typing a CNTRL-D. 


Specially processed in this mode is a line with no characters added to it, which turns into a com- 
pletely blank line (the whitespace provided for the autoindent is discarded.) Also specially processed 
in this mode are lines beginning with a caret (~) and immediately followed by a CNTRL-D. This 
causes the input to be repositioned at the beginning of the line, but retains the previous indent for 
the next line. Similarly, a “0” followed by a CNTRL-D repositions the cursor at the beginning but 
without retaining the previous indent. Autoindent doesn’t happen in global commands. 


autoprint ap default: ap 
Causes the current line to be printed after each ex copy, move, or substitute command. This has the 


same effect as supplying a trailing “p” to each such command. Auwtoprint is suppressed in globals, 
and only applies to the last of many commands on a line. 


autowrite, aw default: noaw 


Causes the contents of the buffer to be automatically written to the current file if you have modified 
it when you give a next, rewind, tag, or ! command, or a CNTRL-* (switch files) or CNTRL-] (tag go 
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to) command. 


beautify, bf default: nobeautify 
Causes all control characters except tab, new line and formfeed to be discarded from the input. A 
complaint is registered the first time a backspace character is discarded. Beautify does not apply to 
command input. 


directory, dir default: dir=/tmp 
Specifies the directory in which vi places the editing buffer file. If this directory is not writable, 
then the editor will exit abruptly when it fails to write to the buffer file. 


edcompatible default: noedcompatible 
Causes the presence or absence of g and c suffixes on substitute commands to be remembered, and 
to be toggled on and off by repeating the suffixes. The suffix r causes the substitution to be like the 
command, instead of like &. 


errorbells,eb default: noeb 
Error messages are preceded by a bell. If possible, the editor always places the error message in 
inverse video instead of ringing the bell. 


hardtabs, ht default: ht=8 
Gives the boundaries on which terminal hardware tabs are set or on which the system expands tabs. 


ignorecase, ic _— default: noic 
Maps all uppercase characters in the text to lowercase in regular expression matching. In addition, 
all uppercase characters in regular expressions are mapped to lowercase except in character class 
specifications enclosed in brackets. 


lisp default: nolisp 
Autoindent indents appropriately for LISP code, and the ( ) { } [[ and ]] commands are modified to 
have meaning for LISP. 


list default: nolist 
All printed lines will be displayed unambiguously, showing tabs and end-of-lines. 


magic default: magic 
If nomagic is set, the number of regular expression metacharacters is greatly reduced, with only up- 
arrow (~) and dollar sign ($) having special effects. In addition the metacharacters “~” and “&” in 
replacement patterns are treated as normal characters. All the normal metacharacters may be made 
magic when nomagic is set by preceding them with a backslash (\). 


mesg default: nomesg 
Causes write permission to be turned off to the terminal while you are in visual mode, if nomesg is 
set. This prevents people writing to your screen with the XENIX write command and scrambling 
your screen as you edit. 


number, n default: nonumber 
Causes all output lines to be printed with their line numbers. 


open default:open 
If set to noopen, the commands open and visual are not permitted from ex. This is set to prevent 
confusion resulting from accidental entry to open or visual mode. 


optimize, opt default: optimize 
Output of text to the screen is expedited by setting the terminal so that it does not perform au- 
tomatic carriage returns when printing more than one line of output, thus greatly speeding output on 
terminals without addressable cursors when text with leading whitespace is printed. 
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paragraphs, para default: para=IPLPPPQPP TPbp 
o Specifies paragraph delimiters for the { and } operations. The pairs of characters in the option’s 
value are the names of the nroff macros that start paragraphs. 


prompt default: prompt 
Ex input is prompted for with a colon (:). If noprompt is set, when ex command mode is entered 
with the Q command, no colon prompt is displayed on the status line. 


redraw default: noredraw 
The editor simulates (using great amounts of output), an intelligent terminal on a dumb terminal. 
Useful only at very high speed. 


remap default: remap 
If on, mapped characters are repeatedly tried until they are unchanged. For example, if o is mapped 
to O and O is mapped to J, o will map to J if remap is set, and to O if noremap is set. 


report default: report=5 
Specifies a threshold for feedback from commands. Any command that modifies more than the 
specified number of lines will provide feedback as to the scope of its changes. For global commands 
and the undo command, which have potentially far reaching scope, the net change in the number of 
lines in the buffer is presented at the end of the command, subject to this same threshold. Thus 
notification is suppressed during a g command on the individual commands performed. 


scroll default: scroll=2 window 
Determines the number of logical lines scrolled when CNTRL-D is received from a terminal input in 
command mode, and the number of lines printed by a command. mode z command (double the value 
of scroll). 


ec sections default: sections=SHNHH HU 
| Specifies the section macros for the [[ and ]] operations. The pairs of characters in the option’s value 
are the names of the nroff macros that start paragraphs. 


shell, sh default: sh=/bin/sh 
Gives the pathname of the shell forked for the shell escape command 
mand. The default is taken from SHELL in the environment, if present. 


669? 
° 


, and by the shell com- 


shiftwidth, sw default: sw=8 
Gives the width of a software tab stop, used in reverse tabbing with CNTRL-D when using autoin- 
dent to append text, and by the shift commands. 


showmatch, sm_ default: nosm 
When a ) or } is typed, moves the cursor to the matching ( or { for one second if this matching 
character is on the screen. 


tabstop, ts default: ts=8 
The editor expands tabs in the input file to be on tabstop boundaries for the purposes of display. 


taglength, tl default: tl=0 
The first taglength characters in a tag name are significant, but all others are ignored. A value of 
zero (the default) means that all characters are significant. 


tags default: tags=tags /usr/lib/tags 


A path of files to be used as tag files for the tag command. A requested tag is searched for in the 
specified files, sequentially. By default files named tag are searched for in the current directory and 


a in /usr/lib. 
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term default=value of shell TERM variable 
The terminal type of the output device. 


terse default: noterse 
Shorter error diagnostics are produced for the experienced user. 


warn default: warn 
Warn if there has been “[No write since last change]”’ before a shell escape command (‘). 


window default: window=speed dependent 
This specifies the number of lines in a text window. The default is 8 at slow speeds (600 baud or 
less), 16 at medium speed (1200 baud), and the full screen (minus one line) at higher speeds. 


w300, w1200, w9600 
These are not true options but set window (above) only if the speed is slow (300), medium (1200), 
or high (9600), respectively. 


wrapscan, ws default: ws 
Searches using the regular expressions in addressing will wrap around past the end of the file. 


wrapmargin, wm default: wm=0 
Defines the margin for automatic insertion of newlines during text input. A value of zero specifies 
no wrap margin. 


writeany, wa default: nowa 
Inhibits the checks normally made before write commands, allowing a write to any file that the 
system protection mechanism will allow. 


Regular Expressions 


A regular expression specifies a set of strings of characters. A member of this set of strings is said to be 
matched by the regular expression. Vi remembers two previous regular expressions: the previous regular 
expression used in a substitute command and the previous regular expression used elsewhere, referred to 
as the previous scanning regular expression. The previous regular expression can always be referred to 
by a null regular expression: e.g., “//” or “??”. 


The regular expressions allowed by vi are constructed in one of two ways depending on the setting of the 
magic option. The ex and vi default setting of magic gives quick access to a powerful set of regular ex- 
pression metacharacters. The disadvantage of magic is that the user must remember that these meta- 
characters are magic and precede them with the backslash (\) to use them as “ordinary” characters. 
With nomagic set, regular expressions are much simpler, there being only two metacharacters. The 
power of the other metacharacters is still available by preceding the now ordinary character with a ‘“‘\’’. 
Note that “\” is thus always a metacharacter. In this discussion the magic option is assumed. With 
nomagic the only special characters are the caret (“) at the beginning of a regular expression, the dollar 
sign ($) at the end of a regular expression, and the backslash (\). The tilde (~) and the ampersand (&) 
also lose their special meanings related to the replacement pattern of a substitute. 


The following basic constructs are used to construct magic mode regular expressions. 


char 
An ordinary character matches itself. Ordinary characters are any characters except a caret (*) at 
the beginning of a line, a dollar sign ($) at the end of line, a star (*) as any character other than 
the first, and any of the following characters: 


on 
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These characters must be escaped (i.e., preceded) by a backslash (\) if they are to be treated as or- 
dinary characters. 


At the beginning of a pattern this forces the match to succeed only at the beginning of a line. 
$ At the end of a regular expression this forces the match to succeed only at the end of the line. 
Matches any single character except the newline character. 


\< Forces the match to occur only at the beginning of a “word”; that is, either at the beginning of a 
line, or just before a letter, digit, or underline and after a character not one of these. 


\> Similar to “\<”’, but matching the end of a “word”, i.e. either the end of the line or before a 
character which is not a letter, a digit, or the underline character. 


[string] 

Matches any single character in the class defined by string. Most characters in string define them- 
selves. A pair of characters separated by a dash (—) in string defines the set of characters between 
the specified lower and upper bounds, thus “[a—z]” as a regular expression matches any single 
lowercase letter. If the first character of string is a caret (~) then the construct matches those char- 
acters which it otherwise would not. Thus “[“a—z]’’ matches anything but a lowercase letter or a 
newline. To place any of the characters caret, left bracket, or dash in string they must be escaped 
with a preceding backslash (\). 


The concatenation of two regular expressions first matches the leftmost regular expression and then the 
longest string that can be recognized as a regular expression. The first part of this new regular expres- 
sion matches the first regular expression and the second part matches the second. Any of the single 
character matching regular expressions mentioned above may be followed by a “star” (*) to form a re- 
gular expression that matches zero or more adjacent occurrences of the characters matched by the 
prefixing regular expression. The tilde (~) may be used in a regular expression to match the text that 
defined the replacement part of the last s command. A regular expression may be enclosed between the 
sequences “\(” and “‘\)” to remember the text matched by the enclosed regular expression. This text 
can later be interpolated into the replacement text using the notation 


\digit 
where digit enumerates the set of remembered regular expressions. 


The basic metacharacters for the replacement pattern are the ampersand (&) and the tilde (~) these are 
given as “\&” and “\~” when nomagic is set. Each instance of the ampersand is replaced by the charac- 
ters matched by the regular expression. In the replacement pattern the tilde stands for the text of the 
previous replacement pattern. 


Other metasequences possible in the replacement pattern are always introduced by a backslash (\). The 
sequence “‘\n’” is replaced by the text matched by the nth regular subexpression enclosed between “\(” 
and “\)”. When nested, parenthesized subexpressions are present, n is determined by counting oc- 
currences of “\(” starting from the left. The sequences “\u” and “‘\l” cause the immediately following 
character in the replacement to be converted to uppercase or lowercase, respectively, if this character is 
a letter. The sequences “\U” and ‘“\L” turn such conversion on, either until ‘“\E” or “‘\e” is encoun- 
tered, or until the end of the replacement pattern. 


Limitations 


When using vi, you should note the following limits: 
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250,000 lines in a file 

1024 characters per line 

256 characters per global command list 

128 characters per filename 

128 characters in the previous inserted and deleted text 
100 characters in a shell escape command 

63 characters in a string valued option 


30 characters in a tag name 


Notes 


The /usr/lib/ex2.13preserve program can be used to restore vi buffer files that were lost as a result of a 
system crash. The program searches the /tmp directory for vi buffer files and places them in the direc- 
tory /usr/preserve. The owner can retrieve these files using the —r option. 


The /usr/lib/ex2.13preserve program must be placed in the system startup file, /etc/re, before the com- 
mand that cleans out the /tmp directory. See the XENIX Operations Guide for more information on 


/ete/re. 
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Name 


vsh - menu driven visual shell 


Syntax 


vsh 


Description 


Vsh is a highly interactive, visually oriented shell which eases many XENIX activities. The vsh features 
both standard and customizable XENIX command menus and on-line help. The vsh displays informa- 
tion and menus in windows on the screen. To enter vsh, simply type 


vsh 


from a shell prompt. Vsh can also be made a user’s default shell by changing their shell entry in 
/etc/passwd (the last colon-separated field). Help is available from all menus by typing the question 
mark character. 


The very last line of the screen is a status line. The status line displays the current pathname, the date, 
time and operating system name. If you have new mail, the status line will indicate so. Above the 
status line is the message line, which displays messages, error or otherwise, from vsh. 


A command menu is displayed at the bottom of the screen. The standard menu contains a range of 
commonly used XENIX commands. Above the command menu is the output window. This window 

a contains a scrolling display of the output from commands. This window is not visible at start-up, but is 
displayed while running certain commands such as ‘=’. 


In the top of the screen is a window with a listing of the current working directory. To alter the size of 
this window use the Window command from the main command menu. Items in the listing window may 
be selected using standard key commands (q.v.). Two special key commands are used with the listing 
window. The equals sign ‘=’ (‘SHOW’) key displays the contents of the currently selected file or direc- 
tory. The minus sign ‘-’ (GOAWAY?’) key will return you to the listing window. 


Commands may be invoked in one of two ways. A command can be selected by pressing the first letter 
of its name. Alternatively, press the space bar. Each time the space bar is pressed, the next menu item 
will be highlighted. This highlighting indicates that the command has been selected. Backspace moves 
to the previous selection. 


Once a command is selected, press the return key. A menu is displayed which gives the valid arguments 
for the particular command. The default choice is shown in parentheses, e.g.: 


recursive: Yes (No) 


To send the output to another program, one may type a vertical bar in the “output:” field of the com- 
mands’ menu. 


When the menu is filled in, press RETURN to start the command. 
Main Menu Commands 


cf The following menu options are available from the standard main menu. Certain sub-commands are 
wy available under the Options selection. These are described in the next section. 
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Copy 
Copy a file to a new file. Copy the contents of a directory to a new directory. 


Delete 
Delete a file or directory. 


Edit 
Invoke an editor for a file. Default is the visual editor vi(C). 


Help 
Get help on diverse topics. A menu is displayed at the bottom of the screen of available help topics. 


Mail 
Send or read XENIX mail. 


Name 
Rename a directory or file. 


Options 
Perform various commands. See OPTIONS section. 


Print 
Print file or files on systems’ lineprinter. 


Quit 
Quit the visual shell. 


Run 
Run a specified XENIX command or applications program. 


View 
View a specified file or directory listing. This file or directory listing will be displayed in the upper 
window. Use the vsh scrolling commands to move around (see KEY COMMANDS Section). 
Window 
Reset upper window ‘redraw’ characteristics and height. 


Options Subcommand 
The Options selection on the main menu has several important commands grouped under the selections 
Directory, Filesystem, Output, and Permissions. These are as follows: 


Directory 


Make 
Make a directory under current working directory. 


Usage 
Display disk usage by number of blocks in current working directory. 
Filesystem 


Create 
Create a filesystem. 
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FilesCheck 
Check file system consistency. 


Mount 
Mount a file system on a specified mount-point. 


SpaceFree 
Report number of disk blocks available on all or some mounted file systems. 


Unmount 
Unmount specified file system if it is not currently busy. 


Output 


VShell 
Echo vsh commands in output window (default). 


XENIX 
Echo actual XENIX commands in output window. For instance, if running “Options Filesystem 
FilesCheck”’, the command fsck will be displayed in the output window if “Options Output Xenix”’ 
is set. 


Permissions 


Change permissions on a file or directory. 


Key Commands 


The following keyboard commands allow editing of menus and fields, and give access to various vsh 
features. 


<CTRL-E> 
Move the cursor up one line. 


<CTRL-X> 
Move the cursor down one line. 


<CTRL-S> 
Move the cursor left one character. 


<CTRL-D> 
Move the cursor right one character. 


<CTRL-R><CTRL-E> 
Scroll page up. 


<CTRL-R><CTRL-X> 
Scroll page down. 


<CTRL-R><CTRL-S> 
Scroll page left. 


<CTRL-R><CTRL-D> 
Scroll page right. 
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<CTRL-Q> 
Home. Go to start of menu. 


<CTRL-Z> 
End. Go to the end of menu. 


<CTRL-C> 
Cancel. Stop present operation and return to the main command menu. 


<RETURN> 
Start the present command. 


<TAB> or <CTRL-I> 
Move to and select entire contents of next field in command line. 


<SPACE> 
Select next item in menu. 


<BACKSPACE> or <CTRL-H> 
Select previous menu item. In editing command lists, deletes character. Replacement text may 
then be typed. 


<CTRL-Y> or <DEL> 
Delete selected character. 


<CTRL-L> 
Move to next character to right of current cursor position. 


<CTRL-K> 
Move to next character to left of current cursor position. 


<CTRL-P> 
Move to next word to right of current cursor position. 


<CTRL-O> 
Move to next word to left of current cursor position. 


? Help. Request information about the selected command or command in progress at the time of the 
request. 


= Show. Display sub-directory listings and text files in directory listings. Display submenus for com- 
mands in main menu. 


- Goaway. Return listing window to current or parent directory after a show command. 
@ Display the Modify menu. 
! — Redraw the screen. 


| Display filter menu. 


Files 


menu.def 
standard menu definition file. 


extension for customized command menus. 
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VSHELL.HPP 

help file 
VSHELL.HPT 

yet another help file 


Notes 


Mouse commands given in the help menus are not yet supported. 
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Name 


wait — Awaits completion of background processes. 


Syntax 


wait 


Description 


Waits until all background processes started with an ampersand (&) have finished and reports on ab- 
normal terminations. 


Because the wait(S) system call must be executed in the parent process, the shell itself executes wait, 
without creating a new process. 


See Also 


sh(C) 
Notes 


Not all the processes of a pipeline with three or more stages are children of the shell, and thus cannot be 
waited for. 
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Name 


wall — Writes to all users. 


Syntax 


/etc/wall 


Description 


Wall reads a message from the standard input until an end-of-file. It then sends this message to all 
users currently logged in preceded by “Broadcast Message from ...”. Wall is used to warn all users, for 
example, prior to shutting down the system. 


The sender should be super-user to override any protections the users may have invoked. 


Files 


/dev/tty* 


See Also 


mesg(C), write(C) 


Diagnostics 


Cannot send to ... The open on a user’s tty file has failed. 
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Name 


wc — Counts lines, words and characters. 


Syntax 


we [ —lwe | [ names | 


Description 


Wc counts lines, words and characters in the named files, or in the standard input if no names appear. 
It also keeps a total count for all named files. A word is a maximal string of characters delimited by 


spaces, tabs, or newlines. 


The options 1], w, and c may be used in any combination to specify that a subset of lines, words, and 
characters are to be reported. The default is —lwe. 


When names are specified on the command line, they will be printed along with the counts. 
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Name 


what — Identifies files. 


Syntax 


what files 


Description 


What searches the given files for all occurrences of the pattern @(#) and prints out what follows until the 
first tilde ("), greater-than sign (>), new-line, backslash (\) or null character. The SCCS command 


get(CP) substitutes this string as part of the @(#) string. 
For example, if the shell procedure in file print contains 


# (@(#)this is the print program 
# (@(#)syntax: print [files] 
pr $* | Ipr 


then the command 
what print 


displays the name of the file print and the identifying strings in that file: 


print: 
this is the print program 
syntax: print [files] 


What is intended to be used with the get(CP) command, which automatically inserts identifying infor- 
mation, but it can also be used where the information is inserted manually. 


See Also 


admin(CP), get(CP) 
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Name 


who — Lists who is on the system. 


Syntax 


who [ who-file ] [ am I ] 


Description 


Who, without an argument, lists the login name, terminal name, and login time for each current XENIX 
user. 


Without an argument, who examines the /etc/utmp file to obtain its information. If a file is given, that 
file is examined. Typically the given file will be /usr/adm/wtmp, which contains a record of all the lo- 
gins since it was created. Then who lists logins, logouts, and crashes since the creation of the wtmp file. 
Each login is listed with user name, terminal name (with /dev/ suppressed), and date and time. When 
an argument is given, logouts produce a similar line without a user name. Reboots produce a line with x 
in the place of the device name, and a fossil time indicative of when the system went down. 


With two arguments, as in who am I (and also who are you), who tells who you are logged in as. 


Files 


/etc/utmp 


See Also 


getuid(S), utmp(M) 
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Name 


whodo — Determines who is doing what. 


Syntax 


/etc/whodo 


Description 


Whodo produces merged, reformatted, and dated output from the who(C) and ps(C) commands. 


See Also 


ps(C), who(C) 
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Name 


write — Writes to another user. 


Syntax 


write user [ tty | 


Description 
Write copies lines from your terminal to that of another user. When first called, it sends the message: 
Message from your-logname your-tty ... 


The recipient of the message should write back at this point. Communication continues until an end-of- 
file is read from the terminal or an interrupt is sent. At that point, write writes 


(end of message) 
on the other terminal and exits. 


If you want to write to a user who is logged in more than once, the tty argument may be used to indi- 
cate the appropriate terminal. 


Permission to write may be denied or granted by use of the mesg(C) command. At the outset, writing is 
allowed. Certain commands, in particular nroff(CT) and pr(C), disallow messages in order to prevent 
messy output. 


If the character ! is found at the beginning of a line, write calls the shell to execute the rest of the line 
as a command. 


The following protocol is suggested for using write: when you first write to another user, wait for him or 
her to write back before starting to send. Each party should end each message with a distinctive signal 
((o) for “over” is conventional), indicating that the other may reply; (oo) for “over and out” is suggested 
when conversation is to be terminated. 


Files 
/etc/utmp To find user 
/bin/sh To execute ! 
See Also 


mail(C), mesg(C), who(C) 
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Name 


xargs — Constructs and executes commands. 


Syntax 


xargs [flags] [ command [initial-arguments ] |] 


Description 


Xargs combines the fixed initial-arguments with arguments read from the standard input to execute the 
specified command one or more times. The number of arguments read for each command invocation 
and the manner in which they are combined are determined by the flags specified. 


Command, which may be a shell file, is searched for using the shell $PATH variable. If command is 
omitted, /bin/echo is used. 


Arguments read in from standard input are defined to be contiguous strings of characters delimited by 
one or more blanks, tabs, or newlines; empty lines are always discarded. Blanks and tabs may be em- 
bedded as part of an argument if escaped or quoted: Characters enclosed in quotes (single or double) are 
taken literally, and the delimiting quotes are removed. Outside of quoted strings a backslash (\) will es- 
cape the next character. 


Each argument list is constructed starting with the initial-arguments, followed by some number of argu- 
ments read from standard input (exception: see —i flag). Flags —i, —l, and —n determine how argu- 
ments are selected for each command invocation. When none of these flags are coded, the initial- 
arguments are followed by arguments read continuously from standard input until an internal buffer is 
full, and then command is executed with the accumulated args. This process is repeated until there are 
no more args. When there are flag conflicts (e.g., —l vs. —n), the last flag has precedence. Flag values 
are: 


—Inumber | Command is executed for each number lines of nonempty arguments from the standard 
input. This is instead of the default single line of input for each command. The last invo- 
cation of command will be with fewer lines of arguments if fewer than number remain. A 
line is considered to end with the first newline unless the last character of the line is a 
blank or a tab; a trailing blank/tab signals continuation through the next nonempty line. 
If number is omitted 1 is assumed. Option —x is forced. 


—ireplstr Insert mode: command is executed for each line from the standard input, taking the entire 
line as a single arg, inserting it in initial-arguments for each occurrence of replstr. A 
maximum of 5 arguments in initial-arguments may each contain one or more instances of 
replstr. Blanks and tabs at the beginning of each line are thrown away. Constructed ar- 
guments may not grow larger than 255 characters, and option —x is also forced. {} is as- 
sumed for replstr if not specified. 


—nnumber Executes command using as many standard input arguments as possible, up to number ar- 
guments maximum. Fewer arguments will be used if their total size is greater than size 
characters, and for the last invocation if there are fewer than number arguments remai- 
ning. If option —x is also coded, each number arguments must fit in the size limitation, 
else xargs terminates execution. 


=I Trace mode: The command and each constructed argument list are echoed to file 
descriptor 2 just prior to their execution. 


—p Prompt mode: The user is asked whether to execute command each invocation. Trace 
mode (—t) is turned on to print the command instance to be executed, followed by a ?... 
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prompt. A reply of y (optionally followed by anything) will execute the command; 
anything else, including just a carriage return, skips that particular invocation of com- 
mand. 


—* Causes xargs to terminate if any argument list would be greater than size characters; —x 
is forced by the options —i and —I. When neither of the options —i, —l, or —n are coded, 
the total length of all arguments must be within the size limit. 


—ssize The maximum total size of each argument list is set to size characters; size must be a po- 
sitive integer less than or equal to 470. If —s is not coded, 470 is taken as the default. 
Note that the character count for size includes one extra character for each argument and 
the count of characters in the command name. 


—eeofstr Eofstr is taken as the logical end-of-file string. Underscore (_) is assumed for the logical 
EOF string if —e is not coded. —e with no eofstr coded turns off the logical EOF string 
capability (underscore is taken literally). Xargs reads standard input until either end-of- 
file or the logical EOF string is encountered. 


Xargs terminates if it either receives a return code of —1 from, or if it cannot execute, command. 
When command is a shell program, it should explicitly exit (see sh(C)) with an appropriate value to 
avoid accidentally returning with —1. 


Examples 


The following will move all files from directory $1 to directory $2, and echo each move command just 
before doing it: 


Is $1 | xargs —i —t mv $1/{} $2/{} 


The following will combine the output of the parenthesized commands onto one line, which is then 
echoed to the end of file Jog: 


(logname; date; echo $0 $*) | xargs >>log 
The user is asked which files in the current directory are to be printed and prints them one at a time: 
Is | xargs —p —1 Ipr 
Or many at a time: 
Is | xargs —p —l | xargs Ipr 


The following will execute diff(C) with successive pairs of arguments originally typed as shell argu- 
ments: 


echo $* | xargs —n2 diff 
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Name 


yes — Prints string repeatedly. 


Syntax 


yes | string | 


Description 


66.99 


Yes repeatedly outputs “‘y’, or if a single string argument is given, then arg is output repeatedly. The 
command will continue indefinitely unless aborted. Useful in pipes to commands that prompt for input 


and require a “y’ response for a yes. In this case, yes terminates when the command it pipes to ter- 
minates, so that no infinite loop occurs. 
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Name 


intro — Introduction to miscellaneous features and files. 


Description 


This section contains miscellaneous information useful in maintaining the system. Included are descrip- 
tions of files, devices, tables and programs that are important in maintaining the entire system. 
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Name 


Cc 


acu — Modem Auto-dialer interface. 


Description 


The Automatic Call Unit interface is provided by the files /dev/cua/01] which are device entries, and by 
their corresponding driver which simulates a standard DN dialer. To place an outgoing call one forks a 
sub-process trying to open /dev/cul0 and then opens the corresponding file /dev/cua0 file and writes a 
number on it. The driver translates the call to proper format for the Automatic Dial Module. 


The codes for the phone numbers are the same as in the DN interface: 


0-9 dial 0-9 
— delay 4 seconds 
<_ end-of-number 


The entire telephone number must be presented in a single write system call. The phone number must 
have an end-of-number code. 


It is also required that the provided line devices (/dev/cul[01]) be used and not the tty devices 
(/dev/tty[12]) when dialing out (as with the cu or uucp commands). 


The minor number of the line device (eg, /dev/cul?) is the minor number of the serial line that the 
modem with automatic call capabilities is connected to. The minor number for the dial device (eg, 
/dev/cua?) is a little different. It has the high bit ON to indicate an ACU device (0x80). The lower 5 
bits of its minor number correspond with the minor number of the coresponding serial device. Bits 6 
om and 7 are set to indicate what speed you would like to dial at. When set to 0 (00, both bits OFF), this 
indicates that the kernel should figure out what speed the modem is set at and dial at that speed. This 
is mostly useful for modems which have an external speed switch. If they are set to 1 (01), this indi- 
cates that the kernel should dial out at 300 baud unconditionally. When they are 2 (10), the kernel 
dials out at 1200 baud unconditionally. This way, you can select a speed on modems which auto-baud. 


For example, a modem on /dev/tty01 (serial channel A) would have a dialer minor number of 129 (= 1 | 
0x80) and a line minor number of 1. 


Files 
/dev/cua0 virtual dialer #0 (uses tty01) 
/dev/cual virtual dialer #1 (uses tty02) 
/dev/cul0 the line which is connected to dialer 0 
/dev/cull the line which is connected to dialer 1 
See Also 


cu(C), uucp(C) 


Notes 


Currently, only the Radio Shack Modem II, the DC-2212, and the DC-1200 with an Automatic Call 
Unit are supported. 
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Name 


a 


aliases, aliases.hash, maliases, faliases — Micnet aliasing files. 


Description 


These files contain the alias definitions for a Micnet network. Aliases are short names or abbreviations 
that may be used in the mail command to refer to specific machines or users in a network. Aliasing al- 
lows a complex combination of site, machine, and user names to be represented by a single name. 


The aliases, maliases, and faliases files each define a different type of alias. The aliases file defines the 
standard aliases which are names for specific systems and users and, in some case, for commands. The 
maliases file defines machine aliases, names and paths for specific systems. The faliases file defines 
forwarding aliases which are temporary names for forwa:ding mail intended for one system or user to 
another. 


The aliases.hash file is the hashed version of the aliases file created by the aliashash command. The file 
is used by the mail command to resolve all standard aliases and is identical to the aliases file except for 
a hash table at the beginning of the file. The hash table allows for more efficient access to the entries in 
the file. The aliases file need only be present to generate the aliases.hash file. The aliases file is not re- 
quired to run the network. 


Each file contains zero or more lines. If hashing is to be performed, at least one alias is required. Each 
line lists the alias and its meaning. The alias meaning can have site, machine, and user login names and 
other aliases (its exact composition depends on the type of alias). A colon (:) separating the alias and 
meaning is required. 


cc” In the aliases file, a line can have the forms: 
alias:[[site!]machine:]user[,[[site!] machine:]user)]... 
alias:[[site!]machine:]command-pipeline 
alias:error-message 


Site and machine are the site and machine names of the system to which the user belongs or on which 
the specified command is to be executed. The site and machine names must end with an exclamation 
mark (!) or colon (:), respectively, and must be defined in a systemid file. A machine alias may be used 
in place of a site and machine name if it is followed by a question mark. 


User is a user login name or another alias. User names in a list must be separated by commas. A new- 
line may immediately follow a comma. Spaces and tabs are allowed, but only immediately before or 
after a comma or newline. 


Command-pipeline is any valid command (with necessary arguments) preceded by a pipe symbol (|) and 
enclosed in double quotation marks. Spaces may separate the command and arguments, but there must 
be no space between the first double quotation mark and the pipe symbol. 


Error-message is any sequence of letters, numbers, and punctuation marks (except a double quotation 
mark) preceded by a number sign (#) and enclosed in double quotation marks. 


In the faliases file, each line can have the same form as lines in the aliases file except that no more than 
one user name can be given for any one alias. To prevent alias expansion on a remote machine, the mea- 
ning should be escaped with “‘\\’’, as in: 


foo: mach?\\foo 
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Failure to do the escape may result in an infinite forwarding loop. If this happens and the loop does not 
invoke a uucp connection, looping will be detected, and the mail will be returned to the sender. 


The alias.hash file has already been searched at this point. If there is no explicit machine given as part 
of the meaning, the recipient will be assumed to be local. After forward aliasing is complete, machine 
aliasing will be performed as necessary. 


In the maliases file a line has the form: 
alias:[[site!]machine:]... 


Site and machine are the site and machine names for a specific network and system. Multiple site and 
machine names direct messages along the specified path of systems. If no site or machine name is given, 
the alias is ignored. 


Before the mail program sends a message, it searches the aliases.hash, faliases, and maliases files to see 
if any of the names given with the command are aliases. Each file is searched in turn,’ (aliases.hash, 
faliases, then maliases) and if a match is found, the alias is replaced with its meaning. If no match is 
found, the name is assumed to be the valid login name of a user on that machine. The search in the 
aliases.hash file continues until all aliases have been replaced, so it is possible for several replacements to 
occur for a single name. Alias loops are now detected. If a loop exists, any recipients involved in the 
alias loop will be dropped from the mail recipient list, and an error message will be generated. The 
faliases file is searched once, from beginning to end, even if it is empty. The maliases file is searched 
only if the alias contains a machine alias. 


When an alias is a user or a list of users, the mail command sends the message to each user in the list. 
When it is a command-pipeline, the mail command starts execution of the command on the specified 
machine and sends the message as input. When the alias is an error-message, the mail command ig- 
nores the message and instead displays the alias and its meaning at the standard error. 


In all files, any line beginning with a number sign (#) is considered a comment and is ignored. 


As a special feature, any alias that contains a site name as the first component of its meaning is automa- 
tically prepended with the machine alias uucp?. This alias may be explicitly defined in the maliases file 
to help direct mail between networks to the system performing the uucp link. 


Directives 


Though alias directives are never included in an alias expansion, they can be used to restrict the expan- 
sion to a class of users, forward the unexpanded alias to another machine, or produce error messages. 
An aliases file may include directives of the form: 


testalias: $xalaska, mikem, georger, terih 
sams: ““$e ambiguous, use samst or samsm”’ 


Fields on the right-hand side of an alias (after the colon), that begin with a $ character, are alias direc- 
tives. If the field contains any blanks or tabs, it must be enclosed in quotes. The directive must precede 
all normal right-hand fields as shown in the example above. The character following the $ specifies the 
directive type: 


$n <real name or description> 
$x <machine> 


$e <error message> 
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$p <permissions > 


$r <restrictions > 


None of the above directives are currently supported in /usr/lib/mail/faliases. Only the $e is supported 
in /usr/lib/mail/maliases and maliases.hash. Unrecognized directives do not create error messages and 
are treated as if they do not exist. The above directives are described in detail as follows: 


$n 


$x 


Se 


$p 


$r 


For a user alias, this field should contain the full real name of the user associated with the alias. 
For a group alias, a description of the group should be given. 


Causes the alias to be forwarded, unexpanded, to the machine specified in this field. White space is 
only allowed immediately following the $x. Since machine aliasing will be performed, the ap- 
propriate machine alias must exist in the maliases file. 


This field contains an error message to be printed. The left side of the alias will be removed from 
the list of users to be aliased. An alternate form of $e is #. 


This field contains the special character, *, or a string of upper and lowercase alphabetic characters. 
Each character indicates that the user on the left-hand side of the alias belongs to a special “‘class” 
of users. The * character implies membership in all such classes. 


This field contains a string of upper and lower case alphabetic characters, each character indicating 
a “class” of users to be granted expansion permision. The absence of a $r field means that any user 
can expand the alias. If the $r field exists, expansion is only allowed if: 


1) the user requesting expansion has a $p field and it contains one or more of the charaters 
found in the $r field, or 


66399 


2) the user has a $p field and it contains a , or 


3) the real user id is O (super user). 


If expansion is not allowed, no error messages result; the alias in question is treated as if it were not 
present. 


To send serious mail delivery problems to root, the following alias could be used: 


network: “$n the network mail recipient,” root 


To forward a group alias called testalias to a machine called alaska and expand it there, the alias below 
may be used: 


Files 


testalias: $xalaska, mikem, georger, terih 


/usr/lib/mail/aliases 


/usr/lib/mail/aliases.hash 


/usr/lib/mail/maliases 


/usr/lib/mail/faliases 


See Also 


aliashash(M), netutil(C), systemid(M), top(M) 
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Name 


aliashash — Micnet alias hash table generator 


Syntax 


aliashash [ -v | [ -o output-file | [ input-file | 


Description 


The aliashash command reads the input-file and generates a output-file containing a hash table of alias 
definitions for a Micnet network. The input-file must name a file containing alias definitions in the 
form described for the aliases file (see aliases(M)). If the —o option is not used to specify an output- 
file , the command creates a file with the same name as the input-file but with .hash appended to it. If 
no input-file is given, the command reads the file named /usr/lib/mail/aliases and creates the file 
named /usr/lib/mail/aliases.hash. 


If invoked with the —v option, the command lists information about the hash table. 


The output-file will contain both the alias definitions given in the input-file and the new hash table. 
The hash table appears at the beginning of the file and is separated from the alias definitions by a blank 
line. The hash table has three or more lines. The first line is: 


#<hash> 


The second line has 4 entries: the bytes per table entry, the maximum number of items per hash value, 
the number of entries in the table, and the offset (in bytes) from the beginning of the file to the begin- 
ning of the alias definitions. 


The next lines (up to the end of the hash table) contain the hash table entries. Each line has 8 entries 
(separated by spaces) and each entry has 2 fields. The first field (1 byte) is a checksum (represented as 
a printable character) the second field is a pointer (in bytes) to the alias definition. The pointer is 
represented as a hexadecimal number with leading blanks if necessary and is always relative to the start 
of the definitions. 


The aliashash command is normally invoked by the install option of the netutil command. If the alias 
definitions of a network must be changed, the definitions in the aliases file should be changed and a new 
aliases.hash file created using the aliashash command. The new aliases.hash file must then be copied to 
all other computers in the network. 

Files 
/usr/lib/mail/aliashash 
/usr/lib/mail/aliases 


/usr/lib/mail/aliases.hash 


See Also 


aliases(M), netutil(C) 
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Warning 


Do not use the aliashash command to create the aliases.hash file while the network is running. If neces- UO 
sary, create a temporary output file, aliases.hash- , using the —o option, then type: 


mv aliases.hash- aliases.hash 


This will prevent disruption of the network. 
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Name 
c 
ascii — Map of the ASCII character set. 
Description 
Ascii is a map of the ASCII character set. It lists both octal and hexadecimal equivalents of each 
character. It contains: 
|000 nul |001 soh |002 stx |003 etx |004 eot |005 enq |006 ack |007 bel | 
O10 Bs. [OLLI he [O12-nl [O13.vt |Ol4 np JOlS cr [016-so. [O17 si | 
1020 dle |021 del |022 dc2 |023 dc3 |024 dce4 |025 nak |026 syn |027 etb | 
1030 can |031 em |032 sub |033 esc |034 fs |035 gs |036 rs |037 us | 
1040 sp |041 ! [042 " (043 # |044$ |045% |046& |047 7 | 
1050 ( |051) |052* |053 + |054, |055— |056. [057 / | 
1060 0 «=©|061 1 0622 (063 3 |0644 |065 5 |0666 |0677 | 
1070 8 = |071 9—Ss—«dJO72.::—~Ss—«073';~—S «074 <~—S«O7S5 = [076 > [0772 | 
1100@ |101A |102B |103C |104D |105E |106F |107G_ | 
Min ttt) ie Wik tie Jism en Tiree | 
ooh iO: “ioe ViesS eet eeu Tieeyw fiorw | 
isos “Mar WaeZ Mase set 3S. se ise. | 
1140 + [141 a |142b [143 c |144d [145 e |146f [147g | 
Mise (0514 }1S2 4. 053% T1540 “fase TisG jis7-e) 4 
1160 p |161q |162r |163 s |164t |165u |166v |167w | 
M70. lati [ee ls ey) oes lige larder | 
00 nul “| 01 sok |°02stx | 0S etx | 04 -e0t | 05 eng: [°06.ack’ | 07 bel | 
cy 08 be <l- Oo te Cant Owe | Oe a Pid ch | Verso JLOr sa, | 
| yO. be: ta der | 1 2dedy | aiaedes | da det: | US mak | 26. syn a oet bh | 
te eeie |) ie em jp ta sub- || tboese Pote-ts [dd-es | Peds: qidlti ais. 4 
36:96. | Se jee oe epee se ee oe | 
eae rae 2) De | 2b + fi Be, | 2d —- a ee ce. | 
460. Paha “ps. ees [sat [eee 1aee- lem 
| 38 8 | 39 9 ih eaaines babes ) Secs | 3d = i oe ees ae | 
(40@ [4A (42m 4x (46D: [45m | 46F are | 
aeme | AGE) ied he cab leek | dew fae? ero: 7 
S62) Wes “Se SSS AOR |S See UTS 
| 58 X | SoC ¥ eer: aes DESbeit + a Les | | oe-” ies ee | 
e008 eel. Ji G2-be lce8o- Veédeed Teese Fb pceeet ioeroe || 
| 68 h } 6 1 | 6a j Mesa s b.6e 1 | 6d m Bie: | 6f o | 
ioc log: W4ese ViGeee da Posse lier Fae. | 
| 78x Wee | Ja z ess L te. | ee vec | 7f del | 
Files 
/usr/pub/ascii 
a 
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Name 


a 


cd — cartridge disk. 


Description 
The cartridge disk interface is also under the "disk" major number. 


The binary representation of the minor device number is encoded 00ccddppp, where cc is the controller 
number (10 [= 2] is the cartridge disk controller), dd is a physical drive number (zero or one), and ppp 
is a disk partition (subsection) within a physical unit. The descriptions of the disk partitions are: 


disk description 

0 entire disk, except boot and diagnostic tracks 
| file system on disk, if any, else invalid 

2 swap area on disk, if any, else invalid 

3 boot track 

4 reserved 

5 reserved 

6 reserved 

7 reserved 


The swap area on a disk is defined to begin at the end of the file system (if any) on the disk and include 
the rest of the disk. The names of the boot-track partitions conventionally have the letters ‘bt’ inserted 
before the drive number. 


The block files access the disk via the system’s normal buffering mechanism and may be read and 
c™ written without regard to physical disk records. 


A ‘raw’ interface provides for direct transmission between the disk and the user’s read or write buffer. 
A single read or write call results in exactly one I/O operation and therefore raw I/O is considerably 
more efficient when many words are transmitted. The names of the raw files conventionally begin with 
an extra ‘r.’ In raw I/O the buffer must begin on a word boundary, the disk address must be an exact 
multiple of 512, and the number of bytes in the I/O request must be a multiple of 512. 


If a disk drive holds the current root filesystem, then ‘root’ and ‘rroot’ are conventionally used to refer to 
the normal and raw interfaces to the filesystem partition of the given disk drive. Similarly, if a disk 
drive is being used as the current swap device, then ‘swap’ is conventionally used to refer to the swap 
partition of that drive. 


Files 


/dev/cd?, /dev/red?, /dev/cdbt?, /dev/rcdbt?, /dev/swap, /dev/root, /dev/rroot 


See Also 
fd(M), hd(M) 


Notes 


In programs that are likely to access raw devices, read, write and Iseek(S) should always deal in 512- 
byte multiples. 
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Name 


console — serial terminal interface. 


Description 


The standard Model 16 supports three terminals, one of which, the system console, does not use a true 
serial electrical interface. Because the console is not truly serial, it ignores requests to change line 
speeds. Except for the console, the serial lines behave as documented in tty(M). 


Files 


/dev/console, /dev/tty01, /dev/tty02 


See Also 


tty(M) 


Notes 


The keys of the console terminal are specially mapped; some control-key combinations produce unex- 
pected codes. This key mapping is documented elsewhere. Full support for modem control signals is not 
implemented. 
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Name 


daemon.mn — Micnet mailer daemon 


Syntax 


/usr/lib/mail/daemon.mn [-ex] 


Description 


The mailer daemon performs the “backend” networking functions of the mail, rcp, and remote com- 
mands by establishing and servicing the serial communication link between computers in a Micnet 
network. 


When invoked, the daemon creates multiple copies of itself, one copy for each serial line used in the 
network. Each copy opens the serial line, creates a startup message for the LOG file, and waits for a 
response from the daemon at the other end. The startup message lists the names of the machines to be 
connected, the serial line to be used, and the current date and time. If the daemon receives a correct 
response, it establishes the serial link and adds the message “‘first handshake complete” to the LOG file. 
If there is no response the daemon waits indefinitely. 


If invoked with the —x switch, the daemon records each transmission in the LOG file. A transmission 
entry shows the direction of the transmission (tx for transmit, rx for receive), the number of bytes 
transmitted, the elasped time for the transmission (in minutes and seconds), and the time of day of the 
transmission (in hours, minutes, and seconds). Each entry has the form: 


direction byte count elasped_time time_of day 


The daemon also records the date and time every hour. The date and time have the same format as 
described for the date command. 


If invoked with the —e switch, the daemon records all transmission errors in the LOG file. An error 
entry shows the cause of the error preceded by the name of the daemon subroutine which detected the 
error. 


The mailer daemon is normally invoked by the start option of the netuti] command and is stopped by 
the stop option. 


During the normal course of execution, the mailer daemon uses several files in the 
/usr/spool/micnet/remote directory. These files provide storage for LOG entries, commands issued by 
the remote(C) command, and a list of processes under daemon control. 
Files 
/usr/lib/mail/daemon.mn 
/usr/spool/micnet/remote/*/LOG 
/usr/spool/micnet/remote/*/mn 
/usr/spool/micnet /remote/local/mn* 
/usr/spool/micnet /remote/lock 


/usr/spool/micnet /remote/pids 
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See Also 


netutil(C) 
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o™ Name 


default — Default program information directory. 


Description 


The files in the directory /etc/default contain the default information used by system commands such as 
backup(C) and remote(C). Default information is any information required by the command that is not 
explicitly given when the command is invoked. 


The directory may contain zero or more files. Each file corresponds to one or more commands. A com- 
mand searches a file whenever it has been invoked without sufficient information. Each file contains 
zero or more entries which define the default information. Each entry has the form: 


keyword 
or 
keyword=value 


where keyword identifies the type of information available and value defines its value. Both keyword and 
value must consist of letters, digits, and punctuation. The exact spelling of a keyword and the ap- 
propriate values depend on the command and are described with the individual commands. 


Any line in a file beginning with a number sign (#) is considered a comment and is ignored. 


co Files 


/etc/default /backup 
/etc/default /console/keys 
/etc/default /console/screen 
/etc/default /console/strings 
/etc/default/dumpdir 
/etc/default/login 
/etc/default /Ipd 
/etc/default /micnet 
/etc/default /mkuser 
/etc/default / passwd 
/etc/default/quot 
/etc/default/restor 


/etc/default /su 


co /etc/default/tar 
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See Also 


backup(C), console(M), dumpdir(C), Ipr(C), mkuser(C), pwadmin(C), quot(C), remote(C), restore(C) 
su(C), tar(C), login(M) 


b] 


Note 


Not all commands use /etc/default files. Please refer to the manual page for a specific command to 
determine if /etc/default files are used, and what information is specified. 
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Name 


dial — Dials a modem. 


Synopsis 
/etc/dial line telno 


/etc/dial —h 


Description 


/etc/dial dials a modem which is attached to Jine, or hangs up the modem. It may be an sh(C) script or 
a compiled “C” program. 


uucp(C) uses /etc/dial, if the program exists and is executable, instead of built in dial routines. 
Currently, built in dial routines are for the Hayes Smartmodem, therefore Hayes users should not have 
an /etc/dial. For other auto dial modems, the program is needed. 


uucp(C) invokes /etc/dial twice, once to dial the number, and again to hang up the modem when 
uucp(C) is finished calling. /etc/dial, when invoked with a line name and telno (phone number), at- 
tempts to dial the phone number on the specified line. When data transfer is finished, the —h option is 
used to hang up the modem. If the modem responds to a drop in DTR, /etc/dial —h need not echo hang 
up commands, since uucp(C) sets HUPCL (hang up on close) before /etc/dial is first called. If the 
modem needs hang up commands, these must be echoed, with the proper line number, from /etc/dial. 


The following is the shell script /etc/dial.example (for the Hayes): 


case $1 in 
—h exit: 0 3: 
—*) exit | 3; 
*) echo ATDT $ {2} “M > $1; Sige o> CxIL OS 
esac 


This shell script should work for the Ven—Tel MD212 PLUS: 


case $1 in 
=—h) exit 0 3 
—*) exit | :: 
*) echo M M\<K$ {2} “M\> > $1; sleep 5 ; exit 0 ;; 
esac 


Files 


/etc/dial.example — an example dial shell script. 


See Also 


uucp(C), uux(C) 
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Name 


environ — The user environment. 


Description 


The user environment is a collection of information about a user, such as his login directory, mailbox, 
and terminal type. The environment is stored in special “environment variables,” which can be assigned 
character values, such as names of files, directories, and terminals. These variables are automatically 
made available to programs and commands invoked by the user. The commands can then use the values 
to access the user’s files and terminal. 


The following is a short list of environment variables. 


PATH Defines the search path for the directories containing commands. The system searches 
these directories whenever a user types a command without giving a full pathname. The 
search path is one or more directory names separated by colons (:). Initially, PATH is set 
to :/bin:/usr/bin. 


HOME Names the user’s login directory. Initially, HOME is set to the login directory given in the 
user’s passwd file entry. 


TERM Defines the type of terminal being used. This information is used by commands such as 
more(C) which rely on information about the capabilities of the user’s terminal. The vari- 
able may be set to any valid terminal name (see terminals(M)) directly or by using the 
tset(C) command. 


TZ Defines time zone information. This information is used by date(C) to display the ap- 
propriate time. The variable may have any value of the form xxxnzzz where xxx is stan- 
dard local time zone abbreviation, n is the difference in hours from GMT, and zzz is the 
daylight-saving local time zone abbreviation (if any). For example, ESTSEDT. 


The environment can be changed by assigning a new value to a variable. An assignment has the form 
name=value 

For example, the assignment 
TERM=h29 


sets the TERM variable to the value “h29”. The new value can be “exported” to each subsequent invo- 
cation of a shell by exporting the variable with the export command (see sh(C)) or by using the env(C) 
command. 


A user may also add variables to the environment, but must be sure that the new names do not conflict 
with exported shell variables such as MAIL, PS1, PS2, and IFS. Placing assignments in the .profile file is 
a useful way to change the environment automatically before a session begins. 


Note that the environment is made available to all programs as a string of arrays. Each string has the 
form: 


name=value 


where the name is the name of an exported variable and the value is the variable’s current value. For 
programs started with a exec(S) call, the environment is available through the external pointer environ. 
For other programs, individual variables in environment are available through getenv(S) calls. 
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See Also 


env(C), login(M), sh(C), exec(S), getenv(SC), profile(M) 
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Name 


cy 


fd — floppy disk. 


Description 


The floppy disk interface can deal with a variety of disk formats; multiple densities and track and sector 
sizes are supported. When a floppy drive becomes active, the disk format is automatically sensed; the 
user can use one device name to deal with any supported disk format. 


The binary representation of the minor device number is encoded O00ccddppp, where cc is the controller 
number (00 is the floppy controller); dd is a physical drive number from zero to three, inclusive; and 
ppp is a disk partition (subsection) within a physical unit. The descriptions of the disk partitions are: 


isk description 
entire disk, except boot track (if any) 
file system on disk, if any, else invalid 
potential swap area on disk, if any, else invalid 
boot track, if any, else invalid 
reserved 
reserved 
reserved 
reserved 


ANN PWNK Oa 


The swap area on a disk is defined to begin at the end of the file system (if any) on the disk and include 
the rest of the disk. The names of the boot-track partitions conventionally have the letters ‘bt’ inserted 
before the drive number. 


Standard Model-16 XENIX double-sided floppies hold 2448 blocks, not counting the boot track. Stan- 
dard single-sided floppies hold 1216 blocks. The boot track on standard floppies holds 26 sectors, each 
of 128 bytes. : 


The block files access the disk via the system’s normal buffering mechanism and may be read and 
written without regard to physical disk records. 


A ‘raw’ interface provides for direct transmission between the disk and the user’s read or write buffer. 
A single read or write call results in exactly one I/O operation and therefore raw I/O is considerably 
more efficient when many words are transmitted. The names of the raw files conventionally begin with 
an extra ‘r.’ In raw I/O, the buffer must begin on a word boundary, the disk address must be an exact 
multiple of 512, and the number of bytes in the I/O request must be a multiple of 512. 


If a disk drive holds the current root filesystem, then ‘root’ and ‘rroot’ are conventionally used to refer to 
the normal and raw interfaces to the filesystem partition of the given disk drive. Similarly, if a disk 
drive is being used as the current swap device, then ‘swap’ is conventionally used to refer to the swap 
partition of that drive. 


Files 


/dev/fd?, /dev/rfd?, /dev/fdbt?, /dev/rfdbt?, /dev/swap, /dev/root, /dev/rroot 


See Also 


c™ hd(M), cd(M) 
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Notes 


In programs that are likely to access raw devices, read, write and Iseek(S) should always deal in 512- UO 
byte multiples. 
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Name 


fixperm - Correct or initialize file permissions and ownership. 


Synopsis 
fixperm [-c|-s |-n|-v |-f|-1|-S |-d[BSTOA]] specfile 


Description 


For each line in the specification file specfile, fixperm makes the listed pathname conform to a specifica- 
tion. fixperm is typically used to configure a XENIX system upon installation. Only the superuser can 
run fixperm with any flag but -n, -f or -1 (see options). 


The specification file has the following format: Each non-blank line consists of either a comment or an 
item specification. A comment is any text from a pound sign "#" up to the end of the line. There is one 
item specification per line. An item specification consists of a package specifier a permission specifica- 
tion, owner and group specifications, the number of links on the file, and the file name. 


The package specifier conisists of one of the following letters: 
B_ Base Package 

S Software Development 

T Text Processing Package 

O Optional user-defined package. 


After the package specifier is a permission specification. The permission specification consists of a file 
type, followed by a numeric permission specification. The item specification is one of the following char- 
acters: 


x Executable 

a Archive 

e Empty file (create if -c option given) 
b_ Block device 

c Character device 

d Directory 

£ Textile, 


The numeric permission conforms to the scheme described in chmod(C). The owner and group per- 
missions are in the third column separated by a slash: e.g.: "bin/bin". The fourth column indicates 
the number of links. If there are links to the file, the next line will contain the linked filename with 
no other information. The fifth column is a pathname. The pathname must be relative, 1.e., not 
preceeded by a slash "/". The sixth column is only used for special files, giving the major and minor 
device numbers. 
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Options 
The following options are available from the command line: 
-c Create empty files and missing directories. 


-d<character> 
Process input lines beginning with given package specifier character (see above). For instance, -dT 
will only process items specified as belonging to the Text Processing Package, -dA will process all 
lines. 


-f List files only on standard output. 

-| List files and directories on standard output. 

-n_ Report all significant errors, other than non-stripped files and those previous to version 3. 

-v_ Report all significant errors, including non-stripped files and executable files previous to version 3. 
-s Modify special device file in addition to the rest of the permlist. 

-S_ Executable files must be x.out format. 


The following two lines make a distribution and invoke tar(C) to archive only the files in base.perm on 
/dev/whatever: 


# /etc/fixperm -f /etc/base.perms > list 
# tar cfF /dev/whatever list 
This example reports base package errors in your file system: 


# /etc/fixperm -n -dB /etc/base.perms 


Notes 


Usually fixperm is only run by a shell script at installation. 
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Name 


getty — Sets terminal mode. 


Syntax 


/etc/getty [| char | 


Description 


Getty automatically adapts a terminal’s serial line to allow proper communication between the terminal 
and the system. It is one of three programs (init(M), getty(M), and /ogin(C)) used by the system to 
enable a terminal and allow user logins. 


Getty is initially called by init which passes a single character argument char (init reads the argument 
from the ttys file). Getty uses char to set the initial line speed and to determine the type of terminal to 
be accessed. It then writes a “system!login:” message, indicating the user may log in on the machine 
named system. 


If the user types a name and terminates it with a newline (ASCII LF) or carriage return (ASCII CR), 
getty scans the name for uppercase alphabetic characters. If only uppercase characters are found, getty 
adapts the system to map all subsequent lowercase characters into the corresponding uppercase charac- 
ters. Furthermore, if the name terminates with a carriage return character, getty sets the terminal’s 
serial line mode to CRMOD (see ioctl(S)). 


If, on the other hand, the user presses the BREAK key, getty writes the login message again. It also 
changes the serial line speed if char is one of those which cause “cycling”’ as described below. This al- 
lows the system to adapt to terminals whose line speeds vary. 


After a name has been typed and scanned, getty passes it to Jogin(C) which asks for the user’s password 
and completes the login process. 


The char argument may be any one of the following: 


0 Cycles through 300-1200-150-110 baud. Useful as a default for dialup lines accessed by a variety of 
terminals. 


— Intended for an on-line Teletype model 33, for example an operator’s console. 
1 Optimized for a 150-baud Teletype model 37. 
2 Intended for an on-line 9600-baud terminal that requires delays, for example the Textronix 4104. 


3 Starts at 1200 baud, cycles to 300 and back. Useful with 212 datasets where most terminals run at 
1200 speed. 


4 Useful for on-line console DECwriter (LA36). 
5 Same as 3 above, but starts at 300. 
6 Intended for machine-to-machine (such as over a network) logins at 2400 baud. 


9 On-line 9600 baud terminal that doesn’t require delays. 
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The following types are intended for general-purpose on-line terminals (unlike the specialized settings 
above), and differ only in the baud rate: 


a 


b 


0 


Getty is intended to be invoked by init(M). 


50 baud. 
75 baud. 
110 baud. 
134.5 baud, usually with 2 stop bits. 
150 baud. 
200 baud. 
300 baud. 
600 baud. 
1200 baud. 
1800 baud. 
2400 baud. 
4800 baud. 
9600 baud. 


External baud rate “A,” usually 19200 baud. 


External baud rate “‘B,” often either 3600 or 7200 baud. 


mended. 


See Also 


login(C), ioctl(S), ttys(F), init(M) 


Files 


/etc/ttys, /etc/systemid 
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Name 
Cc 


group — Format of the group file. 


Description 
Group contains for each group the following information: 
— Group name 
— Encrypted password (optional) 
— Numerical group ID 
— Comma-separated list of all user allowed in the group 


This is an ASCII file. The fields are separated by colons; each group is separated from the next by a 
newline. If the password field is null, no password is demanded. 


This file resides in directory /etc. Because of the encrypted passwords, it can and does have general 
read permission and can be used, for example, to map numerical group IDs to names. 


Files 


/etc/group 


ce” See Also 


newgrp(C), passwd(C), crypt(S), passwd(M) 
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Name 


oO 


hd — hard disk. 


Description 


The hard disk interface can deal with more than one geometry hard disk. Each hard disk must have 
been properly formatted and initialized with the diskutil standalone utility for the hard disk interface to 
function properly. 


The binary representation of the minor device number is encoded 00ccddppp, where cc is the controller 
number (01 is the hard disk controller); dd is a physical drive number from zero to three, inclusive; and 
ppp is a disk partition (subsection) within a physical unit. The descriptions of the disk partitions are: 


disk description 

0 entire disk, except boot and diagnostic tracks 
l file system on disk, if any, else invalid 

2 swap area on disk, if any, else invalid 

3 boot and diagnostic tracks 

4 reserved 

5 reserved 

6 reserved 

7 reserved 


The swap area on a disk is defined to begin at the end of the file system (if any) on the disk and include 

the rest of the disk. The names of the boot-track partitions conventionally have the letters “bt’ inserted 

before the drive number. The boot-track partitions include two tracks; the first of these tracks is the ac- 
ct tual boot track, and the second is reserved for use by diagnostic software. 


The block files access the disk via the system’s normal buffering mechanism and may be read and 
written without regard to physical disk records. 


A ‘raw’ interface provides for direct transmission between the disk and the user’s read or write buffer. 
A single read or write call results in exactly one I/O operation and therefore raw I/O is considerably 
more efficient when many words are transmitted. The names of the raw files conventionally begin with 
an extra ‘r.’ In raw I/O the buffer must begin on a word boundary, the disk address must be an exact 
multiple of 512, and the number of bytes in the I/O request must be a multiple of 512. 


If a disk drive holds the current root filesystem, then ‘root’ and ‘rroot’ are conventionally used to refer to 
the normal and raw interfaces to the filesystem partition of the given disk drive. Similarly, if a disk 
drive is being used as the current swap device, then ‘swap’ is conventionally used to refer to the swap 
partition of that drive. 


Files 


/dev/hd?, /dev/rhd?, /dev/hdbt?, /dev/rhdbt?, /dev/swap, /dev/root, /dev/rroot 


See Also 


fd(M), cd(M) 
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Notes 


In programs that are likely to access raw devices, read, write and lseek(S) should always deal in 512- 
byte multiples. 
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Name 


init — Process control initialization. 


Syntax 


/etc /init 


Description 


The init program is invoked as the last step of the boot procedure and as the first step in enabling termi- 
nals for user logins. nit is one of three programs (init, getty(M), and Jogin(M)) used to initialize a 
system for execution. 


Init creates a process for each terminal on which a user may log in. It begins by opening the console 
device, /dev/console, for reading and writing. It then invokes a shell which asks for a password to start 
the system in maintenance mode. The user may type the password or terminate the shell by typing 
ASCII end-of-file (CNTRL-D) at the console. If the shell terminates, init performs several steps to begin 
normal operation. It invokes a shell and reads the commands in the /etc/re file. This command file 
performs housekeeping tasks such as removing temporary files, mounting file systems, and starting dae- 
mons. Then init reads the file /etc/ttys and forks several times to create a process for each terminal 
device in the file. Each line in the /ete/ttys lists the state of the line (0 for closed, 1 for open), the line 
mode, and the serial line (see ttys(M)). Each process opens the appropriate serial line for reading and 
writing, assigning the file descriptors 0, 1, and 2 to the line and establishing it as the standard input, 
output, and error files. If the serial line is connected to a modem, the process delays opening the line 
until someone has dialed up and a carrier has been established on the line. 


Once init has opened a line, it executes the getty program, passing the line mode as an argument. The 
getty program reads the user’s name and invokes Jogin(M) to complete the login process (see getty(M) 
for details). nit waits until the user logs out by typing ASCII end-of-file (CNTRL-D) or by hanging up. 
It responds by waking up and removing the former user’s login entry from the file utmp, which records 
current users, and makes a new entry in the file wtmp, which is a history of logins and logouts. Then 
the corresponding line is reopened and getty is reinvoked. 


Init has special responses to the hangup, interrupt, and quit signals. The hangup signal SIGHUP causes 
init to change the system from normal operation to maintenance mode. The interrupt signal SIGINT 
Causes init to read the ttys file again to open any new lines and close lines that have been removed. The 
quit signal SIGQUIT causes init to disallow any further logins. In general, these signals have a signifi- 
cant effect on the system and should not be used by a naive user. Instead, similar functions can be 
safely performed with the enable(C), disable(C), and shutdown(C) commands. 

Files 
/dev/tty* 
/etc/utmp 
/usr/adm/wtmp 
/etc/ttys 


/éte/re 
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See Also 


disable(C), enable(C), login(M), kill(C), sh(C), shutdown(C), ttys(M), getty(M) 
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Name 


ld — The link editor. 


Syntax 


Id [ option ] file ... 


Description 


Ld combines several object programs into one, resolves external references, and searches libraries. Ld 
combines the given object files, producing an object module which can be either executed or become the 
input for a further /d run. (In the latter case, the —r option must be given to preserve the relocation 
records.) The output of /d is left by default in the file a.out. This file is made executable only if no er- 
rors occurred. 


The files given as arguments are concatenated in the order specified. The default entry point of the 
output is the beginning of the first routine in the first file. The C compiler, cc , calls /d automatically 
unless given the —c option. The command line that cc passes to /d is 


Id /lib/crt0.o files cc-options -lc 


If any argument is a library, it is searched exactly once at the point it is encountered in the argument 
list. Only those routines defining an unresolved external reference are loaded. If a routine from a li- 
brary references another routine in the library, and the library has not been processed by ranlib(CP), 
the referenced routine must appear after the referencing routine in the library. Thus the order of pro- 
grams within libraries may be important. If the first member of a library is named _.SYMDEF, then 
it is understood to be a dictionary for the library such as produced by ranlib; the dictionary is searched 
iteratively to satisfy as many references as possible. 


The symbols etext, edata and end (etext, edata and end in C) are reserved, and if referred to, are set 
to the first location above the program, the first location above initialized data, and the first location 
above all data, respectively. It is erroneous to define these symbols. 


If no errors occur and there are no unresolved external references, then short form relocation informa- 
tion is attached and the file is made executable. This short form relocation information is sufficient to 
allow the file to be used for another pass of Jd , to change the text and data base addresses. At the 
same time, the —n , —i, or —F options can be used to produce different types of executable files. 


Ld understands several options. Except for —l, they should appear before the names of all object file ar- 
guments. 


—s Strip the output to save space by removing the symbol table and relocation records. Note that strip- 
ping impairs the usefulness of the debugger. This information can also be removed later with 
strip(CP). 


—sr 
Do not attach the short form of relocation. This does not imply removing the symbol table, as with 
a 


—u Take the following argument as a symbol and enter it as undefined in the symbol table. This is 
useful for loading wholly from a library, since initially the symbol table is empty and an unresolved 
reference is needed to force the loading of the first routine. 


—U 
Discard all symbols except those that are undefined external. 
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—g The same as —U, except also retain the following list of global symbols. The list consists of the next 
command line arguments and is terminated by the end of the command line, by — alone, or by any 
further option beginning with a —. 


—G The same as —g, except that the list of global symbols is taken from the file named by the following 
argument. If the next argument is — alone, the standard input is read. The symbols may be 
separated by any type of whitespace. 


=k 
This option is an abbreviation for the library name /lib/libx.a, where x is a string. If the library 
does not exist, /d then tries /usr/lib/libx.a. A library is searched when its name is encountered, so 
the placement of a —I is significant. Note that —l with no argument, defaults to —Ie . If the pro- 
cessor on which ld is running is not the same as the target processor, then it is possible that —p may 
be implied. In the case of the MC68000 target, —p /usr/lib/mlib is implied. 


—p Take the following argument as the directory in which -lx libraries will be found. 


—x Do not preserve local (non.globl) symbols in the output symbol table; only enter external symbols. 
This option saves some space in the output file. 


—X Save local symbols except for those whose names begin with L. This option is used by cc(CP) to 
discard internally generated labels while retaining symbols local to routines. 


—r Generate (long form) relocation records in the output file so that the output file can be the subject 
of another /d run. This flag also prevents final definitions from being given to common symbols and 
suppresses the undefined symbol diagnostics. 


—d Force definition of common storage even if the —r flag is present. 


—nn 
Arrange that when the output file is executed, the text portion will be read-only and shared among 
all users executing the file. This involves moving the data areas up to the first possible page boun- 
dary following the end of the text. A warning is issued if the current machine does not support this 
option. 


—nr 
Identical to —nn except that the text and data positions are reversed. 


—n Identical to whichever of —nn and —nr is the default for the current machine. 


—i When the output file is executed, the program text and data areas are given separate address spaces. 
The only difference between this option and —n is that with —i the data may start at a boundary un- 
related to the position of the text. A warning is issued if the current machine does not support this 
option. 


—o The name argument after —o is used as the name of the /d output file, instead of a.out. 


—e The following argument is taken to be the name of the entry point of the loaded program. The base 
of the text segment is the default. 


—D The next argument is a decimal number that sets the size of the data segment. 


—N The next argument is taken to be a hexidecimal number that sets the pagesize, or rounding size, for 
use with the —n option. With —i, it specifies the base of the data segment. With —nn, it is used to 
compute the base of the data segment. With —nr, it is used to compute the base of the text seg- 
ment. 
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—R The next argument is taken to be a hexidecimal number that is used as the base address for text 
relocation. With —i or —nn, it also specifies the text base address; with —nr it specifies the data 
base address. 


—F The next argument is taken to be a hexadecimal number that specifies the size of the stack required 
by the object file when executing. This only has meaning on those processors that cannot expand 
the stack dynamically. 


Files 
/lib/lib*.a libraries 
/usr/mlib/lib*.a more libraries 
a.out output file 
See Also 


as(CP), ar(CP), cc(CP), ranlib(CP), strip(CP), a.out(F) 


Examples 


Given the existence of the relocatable images ... 


Notes 


This page is identical to Jd(CP). It is provided here so that relocatable images can be transferred 
between XENIX systems. The examples above show the switches that should be used when linking relo- 
catable images created on other systems. 
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Name 


cy 


login — Gives access to the system. 


Description 


The /ogin command is used at the beginning of each terminal session and allows you to identify yourself 
to the system. It cannot be invoked except when a connection is first established, or after the previous 
user has logged out by sending an end-of-file ( CNTRL-D ) to his initial shell. 


Login asks for your user name, and if appropriate, your password. Echoing is turned off (where pos- 
sible) during the typing of your password, so it will not appear on the written record of the session. 


At some installations, an option may be invoked that will require you to enter a second “external” 
password. This will occur only for dial-up connections, and will be prompted by the message “External 
security:”. Both passwords are required for a successful login. 


If password aging has been invoked by the super-user on your behalf, your password may have expired. 
In this case, you will be shunted into passwd(C) to change it, after which you may attempt to log in 
again. 


If you do not complete the login successfully within a certain period of time (e.g., one minute), you are 
likely to be returned to the “‘login:”’ prompt or silently disconnected from a dial-up line. 


After a successful login, accounting files are updated, you are informed of the existence of any mail, and 
the start-up profile files (i.e., /etc/profile and $HOME/.profile) (if any) are executed (see profile(M)). 
Login checks /etc/default/login for environment variables, such as TZ(time zone), HZ(hertz) and 

m ALTSHELL (allows other than sh shell types). Login initializes the user and group IDs and the working 
directory, then executes a command interpreter (usually sh(C)) according to specifications found in the 
/etc/passwd file. Argument 0 of the command interpreter is a dash (—) followed by the last component 
of the interpreter’s pathname. The environment (see environ(M)) is initialized to: 


HOME= your-login-directory 
PATH=:/bin:/usr/bin 


Initially, umask is set to octal 022 by login. 


Files 
/etc/utmp Accounting 
/usr/adm/wtmp Accounting 


/usr/spool/mail/your-name Mailbox for user your-name 


/etc/motd Message of the day 
/etc/default /login Default values for environment 
variables 
/etc/passwd Password file 
/etc/profile System profile 
Cy $HOME/.profile Personal profile 
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See Also 


mail(C), newgrp(C), sh(C), passwd(C), su(C), umask(C), passwd(M), profile(M), environ(M), getty(M) 


Diagnostics 


Login incorrect 
The user name or the password is incorrect. 


No shell, cannot open password file, no directory: 
Your account has not been properly set up. 


Your password has expired. Choose a new one. 
Password aging is implemented and yours has expired. 


Notes 


Under 3.0, only the super-user may execute Jogin from a shell. Hence non-super-users must log out in 
order to log in as another user. However, it is not recommended that Jogin be used as a shell command. 


Furthermore, there has been a change in Jogin’s functionality. Pre-system III Jogin, if invoked from the 
command line while someone is logged on already, logs the current user out and logs in the new user. 
The new 3.0 Jogin nests, i.e., the current user is not logged out. Thus it is somewhat like su, except that 
the new user’s .login or .profile is run. Permissions and environment are those of the new user. When 
the new user logs out, the previous user is still running. This practice is not recommended, as nested lo- 
gins can impair system performance. 
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Name 


cy 


Ip — line printer. 


Description 


The devices rip, Ip, and clp provide the interface to a standard Radio Shack parallel printer attached to 
the parallel output port on the Model 16. Rip is the ‘raw’ line printer device, which passes eight bit 
characters directly to the printer without processing. The minor device number of the ‘raw’ printer 
device is 0. 


Lp is the ‘logical’ printer device. Characters sent to the ‘logical’ printer are specially processed. Line- 
feed and carriage-return characters are treated identically, and cause a line-feed character to be sent to 
the printer if the current print column is equal to zero; if the current column number is non-zero, a 
Carriage-return is sent. 


Tab characters are expanded into an appropriate number of spaces, and form-feeds are expanded into 
the appropriate number of carriage-returns and line-feeds. The driver assumes that tab stops occur at 
eight character intervals; its default number of lines per page is 66. 


Whenever the ‘logical’ line printer is opened, the system’s idea of the current print line and column are 
reset to zero; when the ‘logical’ line printer is closed, the driver forces the printer to its idea of start of 
page. The driver’s idea of current print line and column is also reset whenever a program changes the 
number of lines per page. The minor device number of the ‘logical’ printer device is 128. 


Clp is a special form of the ‘logical’ line printer device for use by certain application programs which 
choose to output directly to the line printer. This device performs all of the tab/newline/form-feed pro- 
co cessing of the ‘logical’ printer; however, it does not force the printer to start of page on close, nor does it 
— reset the current line and column counters when opened. The minor device number of this printer device 
is. 192. 


The device driver interprets the bits of the 8-bit minor device number according to the following scheme. 
The high order bit, if set, indicates that special processing of line printer output should take place. The 
next highest bit, if set, indicates that the driver should ‘remember’ printer line and column positions 
across open/close. This bit is meaningful only if the high order bit is set. The third highest bit, if set, 
indicates that form-feeds issued at start of page should be ignored. Like the second highest bit, this bit 
is meaningful only if the high order bit set. The remaining bits of the minor device number are inter- 
preted as a printer number; currently, only one printer is supported, and these remaining bits must be 
set to 0. 


Files 


/dev/Ip, /dev/rlp, /dev/clp 


See Also 


Ipr(C) 
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Notes 


The ‘logical’ line printer’s idea of current print line and column may be disrupted by various escape se- UO 
quences and control characters. In particular, the ‘logical’ device assumes that the backspace character 

causes the print-head to back up one column if it is not in column zero; if a specific printer does not 

treat the backspace character in this fashion, then a backspace will cause the printer driver’s idea of the 

current print column to become inaccurate. 
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Name 


in 


Machine — Description of host machine. 


Description 


This page lists the internal characteristics of the Tandy 68000 computer and its associated hardware. 
The information is intended for software developers who wish to transfer relocatable object or executable 
files from other XENIX machines to Tandy 68000 machines and then prepare the files for execution on 
Tandy 68000 machines. 


Central Processing Unit Motorola M68000 
Disk Block Size(BSIZE) 512 bytes 
Disk Capacity: 


8 inch/ss Floppy (formatted) 1216 blocks (608K bytes) 
8 inch/ds Floppy (formatted) 2448 blocks (1224K bytes) 


Memory Management Scheme Relocation with MMU 
Memory Page Size 4K bytes 
Shared (Pure) Text Supported 
Variable Stack Size NOT Supported 
Data Relocation Base Addresses: 
‘-_ Impure Text Size of the text 
Pure Text Ox0L 
Text Relocation Base Adresses: 
Impure Text , 0x0L 
Pure Text 0x800000L 


Binary executable files without the required relocation base addresses (as described above) will not run 
on Tandy machines. However, binary executable files with the “short” form of relocation still attached 
can be adapted for execution on Tandy machines with the /d(M) command. See the examples at the 
end of the /d(M) reference page. 

See Also 


ld(M) 
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Name 


makekey — Generates an encryption key. 


Syntax 


/usr /lib/makekey 


Description 


Makekey improves the usefulness of encryption schemes by increasing the amount of time required to 
search the key space. It reads 10 bytes from its standard input, and writes 13 bytes on its standard 
output. The output depends on the input in a way that is intended to be difficult to compute (i.e., to re- 
quire a substantial fraction of a second). 


The first 8 input bytes (the input key) can be arbitrary ASCII characters. The last 2 input bytes (the 
salt) are best chosen from the set of digits, dot (.), slash (/), and uppercase and lowercase letters. The 
salt characters are repeated as the first 2 characters of the output. The remaining 11 output characters 
are chosen from the same set as the sa/t and constitute the output key. 


The transformation performed is essentially the following: the saJ/t is used to select one of 4,096 crypto- 
graphic machines all based on the National Bureau of Standards DES algorithm, but broken in 4,096 
different ways. Using the input key as the key, a constant string is fed into the machine and recircu- 
lated. The 64 bits that come out are distributed into the 66 output key bits in the result. 


Makekey is intended for use with programs that perform encryption (e.g., ed(C) and crypt(C)). 
Usually its input and output will be pipes. 


See Also 


crypt(C), ed(C), passwd(M) 
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Name 


mem, kmem — core memory. 


Description 


Mem is a special file that is an image of the core memory of the computer. It may be used, for ex- 
ample, to examine, and even to patch the system. Kmem is the same as mem except that kernel virtual 
memory rather than physical memory is accessed. 


Byte addresses are interpreted as memory addresses. References to non-existent locations return errors. 
Files 


/dev/mem, /dev/kmem 
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Name 


messages — Description of system console messages. 


Description 


This section describes the various system messages which may appear on the system console. The mes- 
sages are categorized as follows: 


Fatal 
Recovery is impossible. 


System inconsistency 
A contradictory situation exists in the kernel. 


Abnormal 
A probably legitimate but extreme situation exists. 


Hardware 
Indicates a hardware problem. 


Fatal system messages begin with “‘panic:” and indicate hardware problems or kernel inconsistencies that 
are too severe for continued operation. After displaying a fatal message, the system will stop. Re- 
booting is required. 


System inconsistency messages indicate problems usually traceable to hardware malfunction, such as 
memory failure. These messages rarely occur since associated hardware problems are generally detected 
before such an inconsistency can occur. 


Abnormal messages represent kernel operation problems, such as the overflow of critical tables. It takes 
extreme situations to bring these problems about, so they should never occur in normal system use. 


Hardware messages normally specify the device, dev , that caused the error. Each message gives a 
device specification of the form nn/mm where nn is the major number of the device, and mm is its minor 
number. The command pipeline 


Is -1 /dev | grep nn | grep mm 


may be used to list the name of the device associated with the given major and minor numbers. 


System Messages 


** ABNORMAL System Shutdown ** 
This message appears when errors occur during system shutdown. It is usually accompanied by 
other system messages. System inconsistency, fatal 


bad block on dev nn/mm 
A nonexistent disk block was found on, or is being inserted in, the structure’s free list. System in- 
consistency. 


bad count on dev nn/mm 
A structural inconsistency in the superblock of a file system. The system attempts a repair, but this 
message will probably be followed by more complaints about this file system. System incon- 
sistency. 
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Bad free count on dev nn/mm 


A structural inconsistency in the superblock of a file system. The system attempts a repair, but this | 
message will probably be followed by more complaints about this file system. System incon- WV 
sistency. 


error on dev name (nn/mm) 
This is the way that most device driver diagnostic messages start. The message will indicate the 
specific driver and complaint. The name is a word identifying the device. 


iaddress > 2°24 
This indicates an attempted reference to an illegal block number, one so large that it could only 
occur on a file system larger than 8 billion bytes. Abnormal. 


Inode table overflow 
Each open file requires an inode entry to be kept in memory. When this table overflows the 
specific request (usually open(S) or creat(S)) is refused. Although not fatal to the system, this 
event may damage the operation of various spoolers, daemons, the mailer, and other important 
utilities. Anomalous results and missing data files are a common result. Abnormal. 


interrupt from unknown device, vec=xxxx 
The CPU received an interrupt via a supposedly unused vector. This message is followed by 
“panic: unknown interrupt.” Typically this event comes about when a hardware failure miscom- 
putes the vector of a valid interrupt. Hardware. 


no file 
There are too many open files, the system has run out of entries in its “open file” table. The warn- 
ings given for the message “inode table overflow” apply here. Abnormal. 


no space on dev nn/mm ‘> 
This message means that the specified file system has run out of free blocks. Although not nor- UO 
mally as serious, the warnings discussed for “inode table overflow” apply: often user programs are 
written casually and ignore the error code returned when they tried to write to the disk; this results 
in missing data and “holes” in data files. The system administrator should keep close watch on the 
amount of free disk space and take steps to avoid this situation. Abnormal. 


** Normal System Shutdown ** 
This message appears when the system has been shutdown properly. It indicates that the machine 
may now be rebooted or powered down. 


Out of inodes on dev nn/mm 
The indicated file system has run out of free inodes. The number of inodes available on a file 
system is determined when the file system is created (using mkfs(C)). The default number is 
quite generous, this message should be very rare. The only recourse is to remove some worthless 
files from that file system, or dump the entire system to a backup device, run mkfs(C) with more 
inodes specified, and restore the files from backup. Abnormal. 


out of text 

When programs linked with the /d —i or —n switch are run, a table entry is made so that only one 
copy of the pure text will be in memory even if there are multiple copies of the program running. 
This message appears when this table is full. The system refuses to run the program which caused 
the overflow. Note that there is only one entry in this table for each different pure text program. 
Multiple copies of one program will not require multiple table entries. Each “sticky” program (see 
chmod(C)) requires a permanent entry in this table; nonsticky pure text programs require an entry 
only when there is at least one copy being executed. Abnormal. 


panic: bad 287 int 7, 
Attempted execution of a real mode 287 instruction. System incosistency, fatal. 
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panic: blkdev 
An internal disk I/O request, already verified as valid, is discovered to be refering to a nonexistent 
disk. System inconsistency, fatal. 


panic: devtab 
An internal disk I/O request, already verified as valid, is discovered to be refering to a nonexistent 
disk. System inconsistency, fatal. 


panic: 1init 
The super-block of the root file system could not be read. This message occurs only at boot time. 
Hardware, fatal. 


panic: IO err in swap 
A fatal I/O error occurred while reading or writing the swap area. Hardware, fatal. 


panic: memory failure - parity error 
A hardware memory failure trap has been taken. System inconsistency, fatal. 


panic: memory management failure 
An error occurred during memory management operations. System inconsistency, fatal. 


panic: no fs 
A file system descriptor has disappeared from its table. System inconsistency, fatal. 


panic: no imt 
A mounted file system has disappeared from the mount table. System inconsistency, fatal. 


panic: no procs 
Each user is limited in the amount of simultaneous processes he can have; an attempt to create a 
new process when none is available or when the user’s limit is exceeded is refused. That is an oc- 
casional event and produces no console messages; this panic occurs when the kernel has certified 
that a free process table entry is available and yet can’t find one when it goes to get it. System in- 
consistency, fatal. 


panic: Out of swap 
There is insufficient space on the swap disk to hold a task. The system refuses to create tasks 
when it feels there is insufficient disk space, but it is possible to create situations to fool this 
mechanism. Abnormal, fatal. 


panic: general protection trap 
General protection trap taken in kernel. System inconsistency, fatal. 


panic: segment not present 
An attempt has been made to access an invalid segment. It may also indicate the segment-not- 
present trap has been taken in the kernel. System inconsistency, fatal. 


panic: Timeout table overflow 
The timeout table is full. Timeout requests are generated by device drivers, there should usually 
be room for one entry per system serial line plus ten more for other usages. 


panic: Trap in system 
The CPU has generated an illegal instruction trap while executing kernel or device driver code. 
This message is preceded with an information dump describing the trap. System inconsistency, 
fatal. 


panic: Invalid TSS 
Internal tables have become corrupted. System inconsistency, fatal. 
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panic: unknown interrupt 
The CPU received an interrupt via a supposedly unused vector. Typically this event comes about 
when a hardware failure miscomputes the vector of a valid interrupt. Hardware, fatal. 


proc on q 


The system attempts to queue a process already on the process ready-to-run queue. System incon- 
sistency, fatal. 


Trap type 


This message precedes a “panic:” message. The type is the trap number given by the processor. 
The message is followed by a dump of registers. System inconsistency, fatal. 


Notes 


Not all messages appear on all machines. Some messages are processor dependent. 
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Name 


Cy 


micnet — The Micnet default commands file. 


Description 


The micnet file lists the system commands that may be executed through the remote command. The file 
is required for each system in a Micnet network. Whenever a remote command is received through the 
network, the Micnet programs search the micnet file for the system command specified with the remote 
command. If found, the command is executed. Otherwise, the command is ignored and an error mes- 
sage is returned to the system which issued the remote command. 


The file may contain one or more lines. If all commands may be executed, then only the line 
executeall 


is required in the file. Otherwise, the commands must be listed individually. A line that defines an indi- 
vidual command has the form: 


command=commandpath 


Command is the command name to be specified in a remote command. Commandpath is the full path- 
name of the command on the specified system. The equal sign (=) separates the command and com- 
mandpath. For example, the line 


cat=/bin/cat 


a defines the command name cat (used in the remote command) to refer to the system command cat in 
the /bin directory. 


When executeall is set, commands are sought in a series of default directories. Initially, the directories 
are /bin and /usr/bin. The default directories can be explicitly defined in the file by including a line of 
the form: 


execpath=PATH=directory[:directory]... 


The first part of the line, execpath=PATH=, is required. Each directory must be a valid pathname. 
The colon is required to separate directories. For example, the line 


execpath=PATH=/bin:/usr/bin:/usr/bobf/bin 


sets the default directories to /bin, /usr/bin, and /usr/bobf/bin. 


Files 


/etc/default /micnet 


See Also 


aliases(M), netutil(C), systemid(M), top(M) 
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Notes 


The rep command cannot be executed from a remote system unless the micnet file contains either execu- 
teall , or the line 


rcp=/usr/bin/rcp 


June 28, 1985 Page 2 


NULL (M) NULL (M) 


Name 


null — The null file. 


Description 
Data written on a null special file is discarded. 


Reads from a null special file always return 0 bytes. 


Files 


/dev/null 
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Name 


cy 


passwd — The password file. 


Description 
Passwd contains the following information for each user: 

—Login name 
—Encrypted password 
—Numerical user ID 
—Numerical group ID 
—Comment 
—Initial working directory 
—Program to use as shell 


This is an ASCII file. Each field within each user’s entry is separated from the next by a colon (:). The 
comment can contain any desired information. Each user is separated from the next by a newline. If 
the password field is null, no password is demanded; if the shell field is null, sh(C) is used. 


This file resides in the directory /ete. Because the passwords are encrypted, the file has general read 
permission and can be used, for example, to map numerical user IDs to names. 


The encrypted password consists of 13 characters chosen from a 64-character alphabet (., /, 0-9, A—Z, 
a—z), except when the password is null, in which case the encrypted password is also null. Password 
aging is in effect for a particular user if his encrypted password in the password file is followed by a 
comma and a nonnull string of characters from the above alphabet. (Such a string must be introduced 
by the super-user.) The first character of the age denotes the maximum number of weeks for which a 
password is valid. A user who attempts to log in after his password has expired will be forced to supply 
a new one. The next character denotes the minimum period in weeks which must expire before the 
password may be changed. The remaining characters define the week (counted from the beginning of 
1970) when the password was last changed. (A null string is equivalent to zero.) The first and second 
characters must have numerical values in the range 0—63, where the dot (.) is equal to 0 and lowercase 
z is equal to 63. If the numerical value of both characters is 0, the user will be forced to change his 
password the next time he logs in. If the second character is greater than the first, only the super-user 
will be able to change the password. 


Files 


/etc/passwd 


See Also 


login(M), passwd(C), a641(S), crypt(S), getpwent(S), group(M), pwadmin(C). 
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Name 


Cy 


profile — Sets up an environment at login time. 


Description 


The optional file .profile permits automatic execution of commands whenever a user logs in. The file is 
generally used to personalize a user’s work environment by setting exported environment variables and 
terminal mode (see environ(C)). 


When a user logs in, the user’s login shell looks for .profile in the login directory. If found, the shell ex- 
ecutes the commands in the file before beginning the session. The commands in the file must have the 
same format as if typed at the keyboard. Any line beginning with the number sign (#) is considered a 
comment and is ignored. The following is an example of a typical file: 


# Tell me when new mail comes in 
MAIL=/usr/mail/myname 

# Add my /bin directory to the shell search sequence 
PATH=$PATH:$HOME/bin 

# Make some environment variables global 

export MAIL PATH TERM 

# Set file creation mask 

umask 22 


Note that the file /etc/profile is a system-wide profile that, if it exists, is executed for every user before 
the user’s .profile is executed. 


a 


Files 


$HOME/.profile 
/etc/profile 


See Also 


env(C), login(M), mail(C), sh(C), stty(C), su(C), environ(M) 
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Name 


a 


systemid — The Micnet system identification file. 


Description 


The systemid file contains the machine and site names for a system in a Micnet network. A machine 
name identifies a system and distinguishes it from other systems in the same network. A site name 
identifies the network to which a system belongs and distinguishes the network from other networks in 
the same chain. 


The systemid file may contain a site name and up to four different machine names. The file has the 
form: 


[site-name] 
machine-namel 
[machine-name2] 
[machine-name3] 
[machine-name4] 


The file must contain at least one machine name. The other machine names are optional, serving as al- 
ternate names for the same machine. The file must contain a site name if more than one machine name 
is given or if the network is connected to another through a uucp link. The site name, when given, must 
be on the first line. 


Each name can have up to eight letters and numbers but must always begin with a letter. There is 
oa never more than one name to a line. A line beginning with a pound sign (#) is considered a comment 
line and is ignored. 


The Micnet network requires one systemid file on each system in a network with each file containing a 
unique set of machine names. If the network is connected to another network through a uucp link, then 
each file in the network must contain the same site name. 


The systemid file is used primarily during resolution of aliases. When aliases contain site and/or 
machine names the name is compared with the names in the file and removed if there is a match. If 
there is no match, the alias (and associated message, file, or command) is passed on to the specified site 
or machine for further processing. 


Files 


/etc/systemid 


See Also 


aliases(M), netutil(C), top(M) 
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Name 


oO 


Description 


term — Conventional names. 


TERM (M) 


These names are used by certain commands (e.g., nroff(CT), mm(CT), man(CT)) and are maintained 
as part of the shell environment (see sh(C), profile(M), and environ(M)) in the variable $TERM: 


1520 
1620 
1620-12 
2621 
2631 
20s 1=¢ 
2631—e 
2640 
2645 
300 
300-12 
300s 
382 
300s—12 
3045 
33 
37 
40-2 

c 4000A 

| 4014 
43 
450 
450-12 
735 


hp 


tn1200 
tn300 


Datamedia 1520 

Diablo 1620 and others using the HyType II printer 
same, in 12-pitch mode 

Hewlett-Packard HP2621 series 

Hewlett-Packard 2631 line printer 

Hewlett-Packard 2631 line printer - compressed mode 
Hewlett-Packard 2631 line printer - expanded mode 
Hewlett-Packard HP2640 series 

Hewlett-Packard HP264n series (other than the 2640 series) 
DASI/DTC/GSI 300 and others using the HyType I printer 
same, in 12-pitch mode 

DASI/DTC/GSI 300s 

DTC 382 

same, in 12-pitch mode 

Datamedia 3045 

TELETYPE® Model 33 KSR 

TELETYPE Model 37 KSR 

TELETYPE Model 40/2 

Trendata 4000A 

Tektronix 4014 

TELETYPE Model 43 KSR 

DASI 450 (same as Diablo 1620) 

same, in 12-pitch mode 

Texas Instruments TI735 and TI725 

Texas Instruments TI745 

generic name for terminals that lack reverse 
line-feed and other special escape sequences 
Hewlett-Packard (same as 2645) 

generic name for a line printer 

General Electric TermiNet 1200 

General Electric TermiNet 300 


Up to 8 characters, chosen from [—a—z0—9], make up a basic terminal name. Terminal sub-models and 
operational modes are distinguished by suffixes beginning with a —. 
on original vendors, rather than local distributors. A terminal acquired from one vendor should not have 
more than one distinct basic name. 


Names should generally be based 


Commands whose behavior depends on the type of terminal should accept arguments of the form 
—Tterm where term is one of the names given above; if no such argument is present, such commands 
should obtain the terminal type from the environment variable $TERM, which, in turn, should contain 


term. 


SEE ALSO 


2 mm(CT), nroff(CT), sh(C), stty(C), profile(M), environ(M). 


June 28, 1985 


Page 1 


TERM (M) TERM (M) 


Notes 


Programs that ought to adhere to this nomenclature do so somewhat fitfully. Not all XENIX facilities 
support all of these options. 


The use of these terminal types is unrelated of the use of the termcap (M) facility. 
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Name 


a 


termcap — Terminal capability data base. 


Description 


The file /etc/termcap is a data base describing terminals. This data base is used by commands such as 
vi(C), vsh(C), Lyrix, Multiplan and sub—routine packages such as curses(S). Terminals are described 
in termcap by giving a set of capabilities and by describing how operations are performed. Padding re- 
quirements and initialization sequences are included in termcap. 


Entries in termcap consist of a number of ‘:’ separated fields. The first entry for each terminal gives the 
names which are known for the terminal, separated by vertical bar ( | ) characters. The first name is al- 
ways 2 characters long for compatibility with older systems. The second name given is the most 
common abbreviation for the terminal and the name used by wi and ex(C). The last name given should 
be a long name fully identifying the terminal. Only the last name may contain blanks for readability. 


Capabilities (including XENIX Extensions) 


The following is a list of the capabilities that can be defined for a given terminal. In this list, (P) indi- 
cates padding may be specified, (P*) indicates that padding may be based on the number of lines af- 
fected, The capability type and padding fields are described in detail in the following section “Types of 
Capabilities.” 


The codes beginning with uppercase letters (except for CC) indicate XENIX extensions. They are in- 
cluded in addition to the standard entries and are used by one or more application programs. As with 

co the standard entries not all modes are supported by all applications or terminals. Some of these entries 

: refer to specific terminal output capabilities (such as GS for graphics start). Others are to describe 
character sequences sent by keys that appear on a keyboard (such as PU for PageUp key). There are 
also entries which are used to attribute special meanings to other keys (or combinations of keys) for use 
in software programs (such a CTRL—W key(s) being used as the ‘change window’ key in Multiplan). 
Some of the XENIX extension capabilities have a similar function to standard capbilities. They are used 
to redefine specific keys (such as using function keys as arrow keys). The extension capabilities are in- 
cluded in the /etc/termcap file as they are required for some XENIX utilities (such as vsh (C)). The 
more commonly used extension capabilities are described in more detail in the section ““XENIX Exten- 
sions.”’ 


Name Type Pad? Description 


ae str (P)_ End alternate character set 

al str (P*) Add new blank line 

am _ bool Terminal has automatic margins 

as str (P) Start alternate character set 

be str Backspace if not “H 

bs bool Terminal can backspace with “H 

bt str (P) Back tab 

bw bool Backspace wraps from column 0 
to last column 

CC str Command character in prototype 


if terminal settable 
cd str (P*) Clear to end of display 


ce str (P) Clear to end of line 
Cr str Cursor off 
cc ch str (P) Like cm but horizontal motion only, 
line stays same 
Cile:-. sir Sent by CHAR LEFT key 
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cl 
cm 
co 
CO 
cr 
cs 
CV 
CW 
da 
DA 
db 
dB 
dC 
dc 
dF 
dl 
dm 
dN 
do 
dT 
ed 


el 


EN 
eo 
ff 
Gl 
G2 
G3 
G4 
GC 
GD 
GE 
GG 
GH 
GL 
GR 
GS 
GU 
GV 
he 
hd 
HM 
ho 
hu 
hz 
ic 
if 
im 
in 
ip 
is 
k0-k9 
kb 
kd 


str 
str 
num 
str 
str 
str 
str 
str 
bool 
bool 
bool 
num 
num 


num 


num 


num 


str 
bool 


num 


str 
bool 


str 
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(Er) 
(P) 


(P*) 
(P) 
(P) 


(P*) 


(P*) 


ce) 


Clear screen 

Cursor motion 

Number of columns in a line 

Cursor on 

Carriage return, (default “M) 

Change scrolling region (vt100), like cm 
Like ch but vertical only. 

Sent by CHANGE WINDOW key 
Display may be retained above 

Delete attribute string 

Display may be retained below 

Number of millisec of bs delay needed 
Number of millisec of cr delay needed 
Delete character 

Number of millisec of ff delay needed 
Delete line 

Delete mode (enter) 

Number of millisec of nl delay needed 
Down one line 

Number of millisec of tab delay needed 
End delete mode 

End insert mode; give *:ei=:" 

if ic 

Sent by END key 

Can erase overstrikes with a blank 
Hardcopy terminal page eject (default “L) 
Upper-—right (1st quadrant) corner character 
Upper-—left (2nd quadrant) corner character 
Lower-—left (3rd quadrant) corner character 
Lower-right (4th quadrant) corner character 
Center graphics character (similar to “‘+’’) 
Down-—tick character 

Graphics mode end 

Number of chars taken by GS and GE 
Horizontal bar character 

Left—tick character 

Right—tick character 

Graphics mode start 

Up-—tick character 

Vertical bar character 

Hardcopy terminal 

Half-line down (forward 1/2 linefeed) 
Sent by HOME key (if not kh) 

Home cursor (if no cm) 

Half-line up (reverse 1/2 linefeed) 
Hazeltine; can’t print ~’s 

Insert character 

Name of file containing is 

Insert mode (enter); give ‘:im=’ if ic 
Insert mode distinguishes nulls on display 
Insert pad after character inserted 
Terminal initialization string 

Sent by ‘other’ function keys 0-9 

Sent by backspace key 

Sent by terminal down arrow key 
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ke str Out of ‘keypad transmit’ mode 
kh str Sent by home key 
kl str Sent by terminal left arrow key 
kn num Number of ‘other’ keys 
ko str Termcap entries for other non-function keys 
kr str Sent by terminal right arrow key 
ks str Put terminal in ‘keypad transmit’ mode 
ku str Sent by terminal up arrow key 
10-19 str Labels on ‘other’ function keys 
LD - str Sent by line delete key 
LF - str Sent by line feed key 
li num Number of lines on screen or page 
ll str Last line, first column (if no em) 
ma ___ str Arrow key map, used by vi version 2 only 
mi bool Safe to move while in insert mode 
ml str Memory lock on above cursor 
MP - str Multiplan initialization string 
MR - str Multiplan reset string 
ms bool Will scroll in stand—out mode 
mu __ str Memory unlock (turn off memory lock) 
nc bool No correctly working carriage return 
(DM2500,H2000) 
nd str Non-destructive space (cursor right) 
nl str (P*) Newline character (default \n) 
ns bool Terminal is a CRT but doesn’t scroll 
NU | str Sent by NEXT UNLOCKED CELL key 
OS bool Terminal overstrikes 
pe str Pad character (rather than null) 
PR. “se Sent by PAGE DOWN key 
pt bool Has hardware tabs 
(may need to be set with is) 
PU _ str Sent by PAGE UP key 
RC _ str Sent by RECALC key 
RF _ str Sent by TOGGLE REFERENCE key 
RT _ str Sent by RETURN key 
se str End stand out mode 
sf str (P) Scroll forwards 
sg num Number of blank chars left by so or se 
SO str Begin stand out mode 
sr str (P) Scroll reverse (backwards) 
ta str (P) Tab (other than ‘I or with padding) 
tc str Entry of similar terminal - must be last 
te str String to end programs that use cm 
ti str String to begin programs that use cm 
uc str Underscore one char and move past it 
ue str End underscore mode 
ug num Number of blank chars left by us or ue 
ul bool Terminal underlines even though 
it doesn’t overstrike 
up str Upline (cursor up) 
UP ‘str Sent by up—arrow key (alternate to ku) 
us str Start underscore mode 
vb str Visible bell (may not move cursor) 
ve str Sequence to end open/visual mode 
vs str Sequence to start open/visual mode 
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WL - str Sent by WORD LEFT key 

WR J str Sent by WORD RIGHT key 

xb bool Beehive (f1=escape, f2=ctrl C) 

xn bool A newline is ignored after a wrap 
(Concept) 

xr bool Return acts like ce \r \n 
(Delta Data) 

XS bool Standard out not erased by writing over it 
(HP 264?) 

xt bool Tabs are destructive, magic so char 


(Teleray 1061) 
A Sample Entry 


The following entry describes the Concept—100, and is among the more complex entries in the termcap 
file. (This particular concept entry is outdated, and is used as an example only.) 


1 |c100|concept100:is=\EU\Ef\E7\E5\E8\El\ENH\EK\E\200\Eo &\200:\ 
:-al=3*\E*R:am:bs:cd=16*\E*C:ce=16\E’*S:cl=2**L:\ 
:cm=\Ea%+ %+ :co#80:dc=16\E*A:d1=3*\E*B:\ 
:e1=\E\200:e0:im=\E"P:in:ip=16*:1i#24:mi:nd=\E=:\ 
:se=\Ed\Ee:so=\ED\EE:ta=8\t:ul:up=\E;:vb=\Ek\EK:xn: 


Entries may continue onto multiple lines by giving a \ as the last character of a line. Empty fields may 
be included for readability (here between the last field on a line and the first field on the next). Capa- 
bilities in termcap are of three types: Boolean capabilities which indicate that the terminal has some par- 
ticular feature, numeric capabilities giving the size of the terminal or the size of particular delays, and 
string capabilities, which give a sequence which can be used to perform particular terminal operations. 


Types of Capabilities 


All capabilities have two letter codes. For instance, the fact that the Concept has ‘automatic margins’ 
(i.e. an automatic return and linefeed when the end of a line is reached) is indicated by the capability 
am. Hence the description of the Concept includes am. Numeric capabilities are followed by the 
character ‘#’ and then the value. Thus co which indicates the number of columns the terminal has gives 
the value ‘80’ for the Concept. 


Finally, string valued capabilities, such as ce (clear to end of line sequence) are given by the two 
character code, an ‘=’, and then a string ending at the next following ‘:’. A delay in milliseconds may 
appear after the ‘=’ in such a capability, and padding characters are supplied by the editor after the 
remainder of the string is sent to provide this delay. The delay can be either a integer, e.g. ‘20’, or an 
integer followed by an ‘*’, ie. ‘3*’. A ‘* indicates that the padding required is proportional to the 
number of lines affected by the operation, and the amount given is the per-affected-unit padding re- 
quired. When a ‘*’ is specified, it is sometimes useful to give a delay of the form ‘3.5’ to specify a delay 
per unit to tenths of milliseconds. 


A number of escape sequences are provided in the string valued capabilities for easy encoding of charac- 
ters there. A \E maps to an ESCAPE character, “x maps to a control-x for any appropriate x, and the se- 
quences \n \r \t \b \f give a newline, return, tab, backspace and formfeed. Finally, characters may be 
given as three octal digits after a \, and the characters ~ and \ may be given as \* and \\. If it is neces- 
sary to place a : in a capability it must be escaped in octal as \072. If it is necessary to place a null 
character in a string capability it must be encoded as \200. The routines that deal with termcap use C 
strings, and strip the high bits of the output very late so that a \200 comes out as a \000 would. 
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Preparing Descriptions 


We now outline how to prepare descriptions of terminals. The most effective way to prepare a terminal 
description is by imitating the description of a similar terminal in termcap and to build up a description 
gradually, using partial descriptions with ex to check that they are correct. Be aware that a very 
unusual terminal may expose deficiencies in the ability of the termcap file to describe it. To easily test 
a new terminal description you can set the environment variable TERMCAP to a pathname of a file con- 
taining the description you are working on and the editor will look there rather than in /etc/termcap. 
TERMCAP can also be set to the termcap entry itself to avoid reading the file when starting up the 
editor. 


Basic capabilities 


The number of columns on each line for the terminal is given by the co numeric capability. If the ter- 
minal is a CRT, then the number of lines on the screen is given by the li capability. If the terminal 
wraps around to the beginning of the next line when it reaches the right margin, then it should have the 
am capability. If the terminal can clear its screen, then this is given by the cl string capability. If the 
terminal can backspace, then it should have the bs capability, unless a backspace is accomplished by a 
character other than “H in which case you should give this character as the be string capability. If it 
overstrikes (rather than clearing a position when a character is struck over) then it should have the os 
capability. 


A very important point here is that the local cursor motions encoded in termcap are undefined at the left 
and top edges of a CRT terminal. The editor will never attempt to backspace around the left edge, nor 
will it attempt to go up locally off the top. The editor assumes that feeding off the bottom of the screen 
will cause the screen to scroll up, and the am capability tells whether the cursor sticks at the right edge 
of the screen. If the terminal has switch selectable automatic margins, the termcap file usually assumes 
that this is on, i.e. am. 


These capabilities suffice to describe hardcopy and ‘glass-tty’ terminals. Thus the model 33 teletype is 
described as 


t3|33|tty33:co#72:0s 
while the Lear Siegler ADM-3 is described as 
clladm3)3|lsi adm3:am:bs:cl=*Z:li#24:co#80 
Cursor addressing 


Cursor addressing in the terminal is described by a em string capability. This capability uses printf(S) 
like escapes (such as %x) in it. These substitute to encodings of the current line or column position, 
while other characters are passed through unchanged. If the cm string is thought of as being a function, 
then its arguments are the line and then the column to which motion is desired, and the % encodings 
have the following meanings: 


%od replaced by line/column position, 0 origin 
%2 like %2d - 2 digit field 

%3 like %3d - 3 digit field 

%. like printf(S) Yc 

%+x adds x to value, then %. 

%>xy if value > x adds y, no output. 


Jor reverses order of line and column, no output 

Toi increments line/column position (for 1 origin) 

%% gives a single % 

%on exclusive or row and column with 0140 
(DM2500) 
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%B BCD (16*(x/10)) + (x%10), no output. 
%D Reverse coding (x-2*(x%16)), no output. 
(Delta Data). 


Consider the HP2645, which, to get to row 3 and column 12, needs to be sent \E&al2c03Y padded for 
6 milliseconds. Note that the order of the rows and columns is inverted here, and that the row and 
column are printed as two digits. Thus its cm capability is ‘cm=6\E&%r%2c%2Y’. The Microterm 
ACT-IV needs the current row and column sent preceded by a “T, with the row and column simply en- 
coded in binary, ‘“cm="T%.%.’. Terminals which use ‘%.’ need to be able to backspace the cursor (bs or 
bc), and to move the cursor up one line on the screen (up introduced below). This is necessary because 
it is not always safe to transmit \t, \n “D and \r, as the system may change or discard them. 


A final example is the LSI ADM-3a, which uses row and column offset by a blank character, thus 
‘com=\E=%+ %+ ’. 


Cursor motions 


If the terminal can move the cursor one position to the right, leaving the character at the current posi- 
tion unchanged, then this sequence should be given as nd (non-destructive space). If it can move the 
cursor up a line on the screen in the same column, this should be given as up. If the terminal has no 
cursor addressing capability, but can home the cursor (to very upper left corner of screen) then this can 
be given as ho; similarly a fast way of getting to the lower left hand corner can be given as Il; this may 
involve going up with up from the home position, but the editor will never do this itself (unless Il does) 
because it makes no assumption about the effect of moving up from the home position. 


Area clears 


If the terminal can clear from the current position to the end of the line, leaving the cursor where it is, 
this should be given as ce. If the terminal can clear from the current position to the end of the display, 
then this should be given as cd. The editor only uses ed from the first column of a line. 


Insert/delete line 


If the terminal can open a new blank line before the line where the cursor is, this should be given as al; 
this is done only from the first position of a line. The cursor must then appear on the newly blank line. 
If the terminal can delete the line which the cursor is on, then this should be given as dl; this is done 
only from the first position on the line to be deleted. If the terminal can scroll the screen backwards, 
then this can be given as sb, but just al suffices. If the terminal can retain display memory above then 
the da capability should be given; if display memory can be retained below then db should be given. 
These let the editor understand that deleting a line on the screen may bring non-blank lines up from 
below or that scrolling back with sb may bring down non-blank lines. 


Insert/delete character 


There are two basic kinds of intelligent terminals with respect to insert/delete character which can be 
described using termcap. The most common insert/delete character operations affect only the characters 
on the current line and shift characters off the end of the line. Other terminals, such as the Concept 
100 and the Perkin Elmer Owl, make a distinction between typed and untyped blanks on the screen, 
shifting upon an insert or delete only to an untyped blank on the screen which is either eliminated, or 
expanded to two untyped blanks. You can find out which kind of terminal you have by clearing the 
screen and then typing text separated by cursor motions. Type ‘abc def? using local cursor motions 
(not spaces) between the ‘abc’ and the ‘def’. Then position the cursor before the ‘abc’ and put the ter- 
minal in insert mode. If typing characters causes the rest of the line to shift rigidly and characters to 
fall off the end, then your terminal does not distinguish between blanks and untyped positions. If the 
‘abc’ shifts over to the ‘def’ which then move together around the end of the current line and onto the 
next as you insert, you have the second type of terminal, and should give the capability in, which stands 
for ‘insert null’. No known terminals have an insert mode not falling into one of these two classes. 
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The editor can handle both terminals that have an insert mode and terminals which send a simple se- 
quence to open a blank position on the current line. Give as im the sequence to get into insert mode, or 
give it an empty value if your terminal uses a sequence to insert a blank position. Give as ei the se- 
quence to leave insert mode (give this, with an empty value also if you gave im an empty value). Now 
give as ic any sequence needed to be sent just before sending the character to be inserted. Most termi- 
nals with a true insert mode will not support ic, terminals which send a sequence to open a screen posi- 
tion should give it here. (Insert mode is preferable to the sequence to open a position on the screen if 
your terminal has both.) If post insert padding is needed, give this as a number of milliseconds in ip (a 
string option). Any other sequence which may need to be sent after an insert of a single character may 
also be given in ip. 


It is occasionally necessary to move around while in insert mode to delete characters on the same line 
(e.g. if there is a tab after the insertion position). If your terminal allows motion while in insert mode 
you can give the capability mi to speed up inserting in this case. Omitting mi will affect only speed. 
Some terminals (notably Datamedia’s) must not have mi because of the way their insert mode works. 


Finally, you can specify delete mode by giving dm and ed to enter and exit delete mode, and de to delete 
a single character while in delete mode. 


Highlighting, underlining, and visible bells 


If your terminal has sequences to enter and exit standout mode these can be given as so and se respec- 
tively. If there are several flavors of standout mode (such as reverse video, blinking, or underlining — 
half bright is not usually an acceptable ‘standout’ mode unless the terminal is in reverse video mode con- 
stantly) the preferred mode is reverse video by itself. If the code to change into or out of standout mode 
leaves one or even two blank spaces on the screen, as the TVI 912 and Teleray 1061 do, this is accep- 
table, and although it may confuse some programs slightly, it can’t be helped. 


Codes to begin underlining and end underlining can be given as us and ue respectively. If the terminal 
has a code to underline the current character and move the cursor one space to the right, such as the 
Microterm Mime, this can be given as uc. (If the underline code does not move the cursor to the right, 
give the code followed by a nondestructive space.) 


If the terminal has a way of flashing the screen to indicate an error quietly (a bell replacement) then 
this can be given as vb; it must not move the cursor. If the terminal should be placed in a different 
mode during open and visual modes of ex, this can be given as ys and ve, sent at the start and end of 
these modes respectively. These can be used to change, e.g., from a underline to a block cursor and 
back. 


If the terminal needs to be in a special mode when running a program that addresses the cursor, the 
codes to enter and exit this mode can be given as ti and te. This arises, for example, from terminals like 
the Concept with more than one page of memory. If the terminal has only memory relative cursor ad- 
dressing and not screen relative cursor addressing, a one screen-sized window must be fixed into the ter- 
minal for cursor addressing to work properly. 


If your terminal correctly generates underlined characters (with no special codes needed) even though it 
does not overstrike, then you should give the capability ul. If overstrikes are erasable with a blank, then 
this should be indicated by giving eo. 


Keypad 


If the terminal has a keypad that transmits codes when the keys are pressed, this information can be 
given. Note that it is not possible to handle terminals where the keypad only works in local (this applies, 
for example, to the unshifted HP 2621 keys). If the keypad can be set to transmit or not transmit, give 
these codes as ks and ke. Otherwise the keypad is assumed to always transmit. The codes sent by the 
left arrow, right arrow, up arrow, down arrow, and home keys can be given as kl, kr, ku, kd, and kh 
respectively. If there are function keys such as f0, fl, ..., £9, the codes they send can be given as kO, k1, 


June 28, 1985 Page 7 


TERMCAP (M) TERMCAP (M) 


.-» k9. If these keys have labels other than the default f0 through f9, the labels can be given as 10, 11, 

...) 19. If there are other keys that transmit the same code as the terminal expects for the corresponding wo, 
function, such as clear screen, the termcap 2 letter codes can be given in the ko capability, for example, 
‘:ko=cl,ll,sf,sb:’, which says that the terminal has clear, home down, scroll down, and scroll up keys that 

transmit the same thing as the cl, ll, sf, and sb entries. 


The ma entry is also used to indicate arrow keys on terminals which have single character arrow keys. 
It is obsolete but still in use in version 2 of vi, which must be run on some minicomputers due to 
memory limitations. This field is redundant with kl, kr, ku, kd, and kh. It consists of groups of two 
characters. In each group, the first character is what an arrow key sends, the second character is the 
corresponding vi command. These commands are h for kl, j for kd, k for ku, | for kr, and H for kh. For 
example, the Mime would be :ma="Kj Zk*XI: indicating arrow keys left (“H), down (“K), up (*Z), and 
right (“X). (There is no home key on the Mime.) 


Miscellaneous 
If the terminal requires other than a null (zero) character as a pad, then this can be given as pe. 


If tabs on the terminal require padding, or if the terminal uses a character other than “I to tab, then this 
can be given as ta. 


Hazeltine terminals, which don’t allow ‘”’ characters to be printed should indicate hz. Datamedia termi- 
nals, which echo carriage-return linefeed for carriage return and then ignore a following linefeed should 
indicate nc. Early Concept terminals, which ignore a linefeed immediately after an am wrap, should in- 
dicate xn. If an erase-eol is required to get rid of standout (instead of merely writing on top of it), xs 
should be given. Teleray terminals, where tabs turn all characters moved over to blanks, should indicate 
xt. Other specific terminal problems may be corrected by adding more capabilities of the form xx. 


If leading character for commands to the terminal (normally the escape character) can be set by the ( ) 
software, give the command character(s) with the capability CC. 


Other capabilities include is, an initialization string for the terminal, and if, the name of a file contai- 
ning long initialization strings. These strings are expected to properly clear and then set the tabs on the 
terminal, if the terminal has settable tabs. If both are given, is will be printed before if. This is useful 
where if is /usr/lib/tabset/std but is clears the tabs first. 


Similar Terminals 


If there are two very similar terminals, one can be defined as being just like the other with certain ex- 
ceptions. The string capability te can be given with the name of the similar terminal. This capability 
must be /ast and the combined length of the two entries must not exceed 1024. Since termlib routines 
search the entry from left to right, and since the tc capability is replaced by the corresponding entry, the 
capabilities given at the left override the ones in the similar terminal. A capability can be cancelled 
with xx@ where xx is the capability. For example: 


hn|2621nl:ks@:ke@:tc=2621: 


This defines a 2621nl that does not have the ks or ke capabilities, and hence does not turn on the func- 
tion key labels when in visual mode. This is useful for different modes for a terminal, or for different 
user preferences. 
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XENIX Extensions 


Capabilities This table lists the (previously listed) KENIX extensions to the termcap capabilities. It 
shows which codes generate information input from the keyboard to the program reading the keyboard 
and which codes generate information output from the program to the screen. 


Name Input/Output Description 


CF str Cursor off 

Cl. sit Sent by CHAR LEFT key 

CO - str Cursor on 

CW str Sent by CHANGE WINDOW key 

DA _ bool Delete attribute string 

EN _ str Sent by END key 

Gl str Upper-—right (1st quadrant) corner character 
G2 str Upper—left (2nd quadrant) corner character 
G3 str Lower—left (3rd quadrant) corner character 
G4 str Lower-—right (4th quadrant) corner character 
GC. str Center graphics character (similar to +) 
GD - str Down-tick character 

GE _ str Graphics mode end 

GG num Number of chars taken by GS and GE 

GH gtr Horizontal bar character 

GL _ str Letf—tick character 

GR - str Right—tick character 

GS _ str Graphics mode start 

GU str Up-—tick character 

GV _ str Vertical bar character 

HM str Sent by HOME key (if not kh) 

MP - str Multiplan initialization string 

MR - str Multiplan reset string 

NU | str Sent by NEXT UNLOCKED CELL key 
PDO str Sent by PAGE DOWN key 

PU _ str Sent by PAGE UP key 

RC © str Sent by RECALC key 

Rio str Sent by TOGGLE REFERENCE key 

RT © str Sent by RETURN key 

UP str Sent by up—arrow key (alternate to ku) 
WL - str Sent by WORD LEFT key 

WR - str Sent by WORD RIGHT key 


Cursor motion Some application programs make use of special editing codes. CR and CL move the 
cursor one character right and left respectively. WR and WL move the cursor one word right and left 
respectively. CW changes windows, when they are used in the program. 


Some application programs turn off the cursor. This is accomplished using CF for cursor off and CO to 
turn it back on. 


Graphic mode If the terminal has graphics capabilities, this mode can be turned on and off with the GS 
and GE codes. Some terminals generate graphics characters from all keys when in graphics mode (such 
as the Visual 50). The other G codes specify particular graphics characters accessed by escape se- 
quences. These characters are available on some terminals as alternate graphics character sets (not as a 
bit—map graphic mode). The vt100 has access to this kind of alternate graphics character set, but not 
to a bit—map graphic mode. 
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Files 


/etc/termcap _ File containing terminal descriptions 


See Also 


ex(C), curses(S), termcap(S), tset(C), vi(C), more(C), console(M) 


Credit 


This utility was developed at the University of California at Berkeley and is used with permission. 


Notes 


Ex (C) allows only 256 characters for string capabilities, and the routines in termcap(S) do not check 
for overflow of this buffer. The total length of a single entry (excluding only escaped newlines) may not 
exceed 1024. 


The ma, vs, and ve entries are specific to the wi (C) program. 
Not all programs support all entries. There are entries that are not supported by any program. 
XENIX termcap extensions are more fully documented with the software application documentation. 


Refer to console (M) manual page for a description of the character sequences used by the console device 
on your specific XKENIX System. 
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Name 
cy 


terminals — List of supported terminals. 


Description 


The following list, derived from the file /etc/termcap shows, for each terminal, the ‘canonical name’ 
(suitable for use as a TERM shell variable) and a short description of the terminal. The advice in 
termcap (M) will assist users in creating termcap entries for terminals not currently supported. 


Name Terminal 
adds25 adds regent 25 
adm3a lsi adm3a 
adm5 lsi adm5 
dt-100 Tandy DT-100 terminal 
dt100 Tandy DT-100 terminal 
dt-100w Tandy DT-100 terminal 
dtl0Ow Tandy DT-100 terminal 
du dialup 
dumb unknown 
pt100 dec vt100 
pt-100 dec vt100 
pt210 TRS-80 PT-210 printing terminal 
trs100 TRS-80 Model 100 
trs16 TRS-80 Model 16 console 

oo tvi9 10 televideo 910 

\ vt100 dec vt100 
vt-100 dec vt100 
vt100a dec vtl100 emulator 
vtl00e dec vt100 emulator 
vtl00f dec vtl00 emulator extended extended 
vt100n vt100 w/no init 
vt52 dec vt52 emulator 
vt52a dec vt52 emulator 
un unknown 


Files 


/etc/termcap 


See Also 


tset(C), environ(M), termcap(M) 
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Name 


Cy 


top, top.next — The Micnet topology files. 


Description 


These files contain the topology information for a Micnet network. The topology information describes 
how the individual systems in the network are connected and what path a message must take from one 
system to reach another. Each file contains one or more lines of text. Each line of text defines a con- 
nection or a communication path. 


The top file defines connections between systems. Each line lists the machine names of the connected 
systems, the serial lines used to make the connection, and the speed (baud rate) of transmission between 
the systems. Each line has the form: 


machinel ttyl machine2 tty2 speed 


machinel and machine2 are the machine names of the respective systems (as given in the systemid files). 
ttyl and tty2 are the device names (e.g., tty01) of the connecting serial lines. The speed must be an ac- 
ceptable baud rate (e.g., 110, 300, ..., 19200). 


The top.next file contains information about how to reach a particular system from a given system. 
There may be several lines for each system in the network. Each line lists the machine name of a 
system, followed by the machine name of a system connected to it, followed by the machine names of all 
the systems that may be reached by going through the second system. Such a line has the form: 


machinel machine2 machine3 [machine4]... 


The machine names must be the names of the respective systems (as given by the first machine name in 
the systemid files). 


The top.next file must be present even if there are only two computers in the network. In such a case, 
the file must be empty. 


In the top and top.next files, any line beginning with a number sign (#) is considered a comment and is 
ignored. 

Files 
/usr/lib/mail/top 


/usr/lib/mail/top.next 


See Also 


aliases(M), netutil(C), systemid(M), top(M) 
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Name 


tty — General terminal interface. 


Description 


This section describes both a particular special file and the general nature of the terminal interface. 


The file /dev/tty is, in each process, a synonym for the control terminal associated with the process 
group of that process, if any. It is useful for programs or shell sequences that wish to be sure of writing 
messages on the terminal no matter how output has been redirected. It can also be used for programs 
that demand the name of a file for output, when typed output is desired and it is tiresome to find out 
what terminal is currently in use. 


All asynchronous communications ports use the same general interface, no matter what hardware is in- 
volved. The remainder of this section discusses the common features of this interface. 


When a terminal file is opened, it normally causes the process to wait until a connection is established. 
In practice, users’ programs seldom open these files; they are opened by getty(M) and become a user’s 
standard input, output, and error files. The very first terminal file opened by the process group leader of 
a terminal file not already associated with a process group becomes the control terminal for that process 
group. The control terminal plays a special role in handling quit and interrupt signals, as discussed 
below. The control terminal is inherited by a child process during a fork(S). A process can break this 
association by changing its process group using setpgrp(S). 


A terminal associated with one of these files ordinarily operates in full-duplex mode. Characters may be 
typed at any time, even while output is occurring, and are only lost when the system’s character input 
buffers become completely full, which is rare, or when the user has accumulated the maximum allowed 
number of input characters that have not yet been read by some program. Currently, this limit is 256 
characters. When the input limit is reached, all the saved characters are thrown away without notice. 


Normally, terminal input is processed in units of lines. A line is delimited by a newline (ASCII LF) 
character, an end-of-file (ASCII EOT) character, or an end-of-line character. This means that a pro- 
gram attempting to read will be suspended until an entire line has been typed. Also, no matter how 
many characters are requested in the read call, at most one line will be returned. It is not, however, 
necessary to read a whole line at once; any number of characters may be requested in a read, even one, 
without losing information. 


Erase and kill processing is normally done during input. By default, a CNTRL-H or BACKSPACE erases 
the last character typed, except that it will not erase beyond the beginning of the line. By default, a 
CNTRL-U kills (deletes) the entire input line, and optionally outputs a newline character. Both these 
characters operate on a key-stroke basis, independent of any backspacing or tabbing that may have been 
done. Both the erase and kill characters may be entered literally by preceding them with the escape 
character (\). In this case the escape character is not read. The erase and kill characters may be 
changed (see stty(C)). 


Certain characters have special functions on input. These functions and their default character values 
are summarized as follows: 


INTR (Rubout or ASCII DEL) Generates an interrupt signal which is sent to all processes with the 
associated control terminal. Normally, each such process is forced to terminate, but arrange- 
ments may be made either to ignore the signal or to receive a trap to an agreed-upon location; 
see signal(S). 


QUIT (CNTRL-\ or ASCII FS) Generates a quit signal. Its treatment is identical to the interrupt 
signal except that, unless a receiving process has made other arrangements, it will not only be 
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terminated but a core image file (called core) will be created in the current working directory. 


ERASE (CNTRL-H) Erases the preceding character. It will not erase beyond the start of a line, as WY 
delimited by a NL, EOF, or EOL character. 


KILL (CNTRL-U) Deletes the entire line, as delimited by a NL, EOF, or EOL character. 


EOF (CNTRL-D or ASCII EOT) May be used to generate an end-of-file from a terminal. When re- 
ceived, all the characters waiting to be read are immediately passed to the program, without 
waiting for a newline, and the EOF is discarded. Thus, if there are no characters waiting, 
which is to say the EOF occurred at the beginning of a line, zero characters will be passed 
back, which is the standard end-of-file indication. 


NL (ASCII LF) Is the normal line delimiter. It cannot be changed or escaped. 
EOL (ASCII NUL) Is an additional line delimiter, like NL. It is not normally used. 


STOP (CNTRL-S or ASCII DC3) Can be used to temporarily suspend output. It is useful with CRT 
terminals to prevent output from disappearing before it can be read. While output is 
suspended, STOP characters are ignored and not read. 


START (CNTRL-Q or ASCII DC1) Is used to resume output which has been suspended by a STOP 
character. While output is not suspended, START characters are ignored and not read. The 
start/stop characters cannot be changed or escaped. 


The character values for INTR, QUIT, ERASE, KILL, EOF, and EOL may be changed to suit individual 
tastes. The ERASE, KILL, and EOF characters may be escaped by a preceding \ character, in which 
case no special function is carried out. 


When the carrier signal from the dataset drops, a hangup signal is sent to all processes that have this WwW 
terminal as the control terminal. Unless other arrangements have been made, this signal causes the pro- 

cesses to terminate. If the hangup signal is ignored, any subsequent read returns with an end-of-file in- 

dication. Thus programs that read a terminal and test for end-of-file can terminate appropriately when 

hung up on. 


When one or more characters are written, they are transmitted to the terminal as soon as previously- 
written characters have finished typing. Input characters are echoed by putting them in the output 
queue as they arrive. If a process produces characters more rapidly than they can be typed, it will be 
suspended when its output queue exceeds a given limit. When the queue has drained down to the given 
threshold, the program is resumed. 


Several ioctl(S) system calls apply to terminal files. The primary calls use the following structure, 
defined in the file termio.h: 


#define NCC 8 
struct  termio { 
unsigned short c _iflag; /* input modes */ 
unsigned short  c_oflag; /* output modes */ 
unsigned short  c _cflag; /* control modes */ 
unsigned short  c _lflag; /* local modes */ 
char © line: /* line discipline */ 
unsigned char c cc[NCC]; /* control chars */ 
ki 
The special control characters are defined by the array c_cc. The relative positions and initial values for 
each function are as follows: 7, 


June 28, 1985 Page 2 


TTY (M) TTY (M) 
0 VINTR DEL 
1 VQUIT FS 
2 VERASE BKSP 
3 VKILL CNTRL-U, CNTRL-H, 
4 VEOF EOT 
S VEOL NUL 
6 Reserved 
7 Reserved 


The c_iflag field describes the basic terminal input control: 


IGNBRK 0000001 Ignores break condition 

BRKINT 0000002 Signals interrupt on break 

IGNPAR 0000004 Ignores characters with parity errors 
PARMRK 0000010 Marks parity errors 

INPCK 0000020 Enables input parity check 

ISTRIP 0000040 Strips character 

INLCR 0000100 Maps NL to CR on input 

IGNCR 0000200 Ignores CR 

ICRNL 0000400 Maps CR to NL on input 

IUCLC 0001000 Maps uppercase to lowercase on input 
IXON 0002000 Enables start/stop output control 
IXANY 0004000 Enables any character to restart output 
IXOFF 0010000 Enables start/stop input control 


If IGNBRK is set, the break condition (a character framing error with data all zeros) is ignored, that is, 
not put on the input queue and therefore not read by any process. Otherwise, if BRKINT is set the 
break condition will generate an interrupt signal and flush both the input and output queues. If 
IGNPAR is set, characters with other framing and parity errors are ignored. 


If PARMRK is set, a character with a framing or parity error which is not ignored is read as the 3- 
character sequence: 0377, 0, X, where X is the data of the character received in error. To avoid ambi- 
guity in this case, if ISTRIP is not set, a valid character of 0377 is read as 0377, 0377. If PARMRK is 
not set, a framing or parity error which is not ignored is read as the character NUL (0). 


If INPCK is set, input parity checking is enabled. If INPCK is not set, input parity checking is disabled. 
This allows output parity generation without input parity errors. 


If ISTRIP is set, valid input characters are first stripped to 7-bits, otherwise all 8-bits are processed. 


If INLCR is set, a received NL character is translated into a CR character. If IGNCR is set, a received 
CR character is ignored (not read). Otherwise if ICRNL is set, a received CR character is translated 
into a NL character. 


If IUCLC is set, a received uppercase alphabetic character is translated into the corresponding lowercase 
character. 


If IXON is set, start/stop output control is enabled. A received STOP character will suspend output and 
a received START character will restart output. All start/stop characters are ignored and not read. If 
IXANY is set, any input character will restart output which has been suspended. 


If IXOFF is set, the system will transmit START characters when the input queue is nearly empty and 
STOP characters when nearly full. 


The initial input control value is all bits clear. 
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The c_oflag field specifies the system treatment of output: 


OPOST 0000001 Postprocesses output 

OLCUC 0000002 Maps lowercase to uppercase on output 
ONLCR 0000004 Maps NL to CR-NL on output 
OCRNL 0000010 Maps CR to NL on output 
ONOCR 0000020 No CR output at column 0 
ONLRET 0000040 NL performs CR function 
OFILL 0000100 Uses fill characters for delay 
OFDEL 0000200 Fills is DEL, else NUL 
NLDLY 0000400 Selects newline delays: 

NLO 0 

NL1 0000400 

CRDLY 0003000 Selects carriage return delays: 
CRO 0 

CRI 0001000 

CR2 0002000 

CR3 0003000 

TABDLY 0014000 Selects horizontal tab delays: 
TABO 0 

TABI 0004000 

TAB2 0010000 

TAB3 0014000 Expands tabs to spaces 
BSDLY 0020000 Selects backspace delays: 

BSO 0 

BS1 0020000 

VIDEY 0040000 Selects vertical tab delays: 
VTO 0 

VTl 0040000 

FFDLY 0100000 Selects form feed delays: 

FFO 0 

FF1 0100000 


TTY (M) 


If OPOST is set, output characters are post-processed as indicated by the remaining flags, otherwise 
characters are transmitted without change. 


If OLCUC is set, a lowercase alphabetic character is transmitted as the corresponding uppercase 
character. This function is often used in conjunction with IUCLC. 


If ONLCR is set, the NL character is transmitted as the CR-NL character pair. If OCRNL is set, the CR 
character is transmitted as the NL character. If ONOCR is set, no CR character is transmitted when at 
column 0 (first position). If ONLRET is set, the NL character is assumed to perform the carriage return 
function; the column pointer will be set to 0 and the delays specified for CR will be used. Otherwise the 
NL character is assumed to perform the linefeed function; the column pointer will remain unchanged. 
The column pointer is also set to 0 if the CR character is actually transmitted. 
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The delay bits specify how long transmission stops to allow for mechanical or other movement when cer- 
tain characters are sent to the terminal. In all cases a value of 0 indicates no delay. If OFILL is set, fill 
characters will be transmitted for delay instead of a timed delay. This is useful for high baud rate ter- 
minals which need only a minimal delay. If OFDEL is set, the fill character is DEL, otherwise NUL. 


If a form feed or vertical tab delay is specified, it lasts for about 2 seconds. 


Newline delay lasts about 0.10 seconds. If ONLRET is set, the carriage return delays are used instead 
of the newline delays. If OFILL is set, 2 fill characters will be transmitted. 


Carriage return delay type 1 is dependent on the current column position, type 2 is about 0.10 seconds, 
and type 3 is about 0.15 seconds. If OFILL is set, delay type 1 transmits 2 fill characters, and type 2 
transmits 4 fill characters. 


Horizontal tab delay type 1 is dependent on the current column position. Type 2 is about 0.10 seconds. 
Type 3 specifies that tabs are to be expanded into spaces. If OFILL is set, 2 fill characters will be 
transmitted for any delay. 


Backspace delay lasts about 0.05 seconds. If OFILL is set, 1 fill character will be transmitted. 
The actual delays depend on line speed and system load. 
The initial output control value is all bits clear. 


The c cflag field describes the hardware control of the terminal: 


CBAUD 0000017 Baud rate: 

BO 0 Hang up 

B50 0000001 50 baud 

B75 0000002 75 baud 

B110 0000003 110 baud 

B134 0000004 134.5 baud 

B150 0000005 150 baud 

B200 0000006 200 baud 

B300 0000007 300 baud 

B600 0000010 600 baud 

B1200 0000011 1200 baud 

B1800 0000012 1800 baud 

B2400 0000013 2400 baud 

B4800 0000014 4800 baud 

B9600 0000015 9600 baud 

EXTA 0000016 External A 

EXTB 0000017 External B 

CSIZE 0000060 Character size: 

CS5 0 5 bits 

CS6 0000020 6 bits 

CS7 0000040 7 bits 

CS8 0000060 8 bits 

CSTOPB 0000100 Sends two stop bits, else one 
CREAD 0000200 Enables receiver 
PARENB 0000400 Parity enable 
PARODD 0001000 Odd parity, else even 
HUPCL 0002000 Hangs up on last close 
CLOCAL 0004000 Local line, else dial-up 
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The CBAUD bits specify the baud rate. The zero baud rate, BO, is used to hang up the connection. If 


BO is specified, the data-terminal-ready signal will not be asserted. Without this signal, the line is WV 
disconnected if connected through a modem. For any particular hardware, impossible speed changes are 
ignored. 


The CSIZE bits specify the character size in bits for both transmission and reception. This size does not 
include the parity bit, if any. If CSTOPB is set, 2 stop bits are used, otherwise 1 stop bit. For example, 
at 110 baud, 2 stops bits are required. 


If PARENB is set, parity generation and detection is enabled and a parity bit is added to each character. 
If parity is enabled, the PARODD flag specifies odd parity if set, otherwise even parity is used. 


If CREAD is set, the receiver is enabled. Otherwise no characters will be received. 


If HUPCL is set, the line will be disconnected when the last process with the line open closes it or ter- 
minates. That is, the data-terminal-ready signal will not be asserted. 


If CLOCAL is set, the line is assumed to be a local, direct connection with no modem control. The 
data-terminal-ready and request-to-send signals are asserted, but incoming modem signals are ignored. 
If CLOCAL is not set, modem control is assumed. This means the data-terminal-ready and request-to- 
send signals are asserted. Also, the carrier-detect signal must be returned before communications can 
proceed. 


The initial hardware control value after open is B9600, CS8, CREAD, HUPCL. 


The c_/flag field of the argument structure is used by the line discipline to control terminal functions. 
The basic line discipline (0) provides the following: 


ISIG 0000001 Enable signals WY 
ICANON 0000002 Canonical input (erase and kill processing) 

XCASE 0000004 Canonical upper/lower presentation 

ECHO 0000010 Enables echo 


ECHOE 0000020 Echoes erase character as BS-SP-BS 
ECHOK 0000040 Echoes NL after kill character 
ECHONL 0000100 Echoes NL 

NOFLSH — 0000200 Disables flush after interrupt or quit 
XCLUDE 0100000 Exclusive use of the line. 


If ISIG is set, each input character is checked against the special control characters INTR and QUIT. If 
an input character matches one of these control characters, the function associated with that character is 
performed. If ISIG is not set, no checking is done. Thus these special input functions are possible only 
if ISIG is set. These functions may be disabled individually by changing the value of the control 
character to an unlikely or impossible value (e.g. 0377). 


If ICANON is set, canonical processing is enabled. This enables the erase and kill edit functions, and 
the assembly of input characters into lines delimited by NL, EOF, and EOL. If ICANON is not set, read 
requests are satisfied directly from the input queue. A read will not be satisfied until at least VMIN 
characters have been received or the timeout value VTIME has expired. This allows fast bursts of input 
to be read efficiently while still allowing single character input. The VMIN and VTIME values are stored 
in the position for the EOF and EOL characters respectively. The time value represents tenths of 
seconds. 


If XCASE is set, and if ICANON is set, an uppercase letter is accepted on input by preceding it with a \ 
character, and is output preceded by a \ character. In this mode, the following escape sequences are 
generated on output and accepted on input: > 
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For: Use: 
SY \" 
| \! 
2 \" 
{ \( 
} \) 
\ \\ 


For example, A is input as \a, \n as \\n, and \N as \\\n. 
If ECHO is set, characters are echoed as received. 


When ICANON is set, the following echo functions are possible. If ECHO and ECHOE are set, the erase 
character is echoed as ASCII BS SP BS, which will clear the last character from a CRT screen. If 
ECHOE is set and ECHO is not set, the erase character is echoed as ASCII SP BS. If ECHOK is set, the 
NL character will be echoed after the kill character to emphasize that the line will be deleted. Note 
that an escape character preceding the erase or kill character removes any special function. If ECHONL 
is set, the NL character will be echoed even if ECHO is not set. This is useful for terminals set to local 
echo (so-called half duplex). Unless escaped, the EOF character is not echoed. Because EOT is the de- 
fault EOF character, this prevents terminals that respond to EOT from hanging up. 


If NOFLSH is set, the normal flush of the input and output queues associated with the quit and interrupt 
characters will not be done. 


If XCLUDE is set, any subsequent attempt to open the tty device using open(S) will fail for all users ex- 
cept the super-user. If the call fails, it returns EBUSY in errno. XCLUDE is useful for programs which 
must have exclusive use of a communications line. It is not intended for the line to the program’s con- 
trolling terminal. XCLUDE must be cleared before the setting program terminates, otherwise subsequent 
attempts to open the device will fail. 


The initial line-discipline control value is all bits clear. 
The primary ioct](S) system calls have the form: 


ioctl (fildes, command, arg) 
struct termio *arg; 


The commands using this form are: 


TCGETA Gets the parameters associated with the terminal and stores them in the termio struc- 
ture referenced by arg. 


TCSETA Sets the parameters associated with the terminal from the structure referenced by arg. 
The change is immediate. 


TCSETAW Waits for the output to drain before setting the new parameters. This form should be 
used when changing parameters that will affect output. 


TCSETAF Waits for the output to drain, then flushes the input queue and sets the new parame- 
ters. 


Additional ioct/](S) calls have the form: 


ioctl (fildes, command, arg) 
int arg; 


The commands using this form are: 
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TCSBRK Waits for the output to drain. If arg is 0, then sends a break (zero bits for 0.25 
seconds). 
TCXONC Starts/stops control. If arg is 0, suspends output; if 1, restarts suspended output. 
TCFLSH If arg is 0, flushes the input queue; if 1, flushes the output queue; if 2, flushes both 
the input and output queues. 
Files 
/dev/tty 
/dev/tty* 


/dev/console 


See Also 


stty(C), ioctl(S) 


June 28, 1985 Page 8 


TTYS (M) TTYS (M) 


Name 


ttys — Login terminals file. 


Description 


The /etc/ttys file contains a list of the device special files associated with possible login terminals, and 
defines which files are to be opened by the init(M) program on system start-up. 


The file contains one or more entries of the form 
state mode name 


The name must be the filename of a device special file. Only the filename may be supplied, the path is 
assumed to be /dev. If state is “1”, the file is enabled for logins; if ‘0’’, the file is disabled. The mode 
is used as an argument to the getty(M) program. It defines the line speed and type of device associated 
with the terminal. A list of arguments is provided in getty(M). 


For example, the entry “mtty02” means the serial line tty02 is to be opened for logging in at 9600 baud. 


Files 


/etc/ttys 


See Also 


init(M), getty(M), enable(C), disable(C) 


Notes 


The /etc/ttys file should only be edited when the system is in system maintenance mode. If it is edited 
when the system is in multi-user mode, the changes will not take effect until the system is rebooted, or 
until an enable or disable command is given. See the XENIX Operations Guide. 
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Name 


utmp, wtmp — Formats of utmp and wtmp entries. 


Description 
The files utmp and wtmp hold user and accounting information for use by commands such as who(C), 
acctconl (see acctcon(C)), and login(M). They have the following structure, as defined by 
/usr /include /utmp.h: 


struct utmp 


{ 
char —_ut_line[8]; /* tty name */ 
char _ut_name[8]; /* login name */ 
long __ut_time; /* time on */ 


Files 
/etc/utmp 
/usr/adm/wtmp 


/usr/include/utmp.h 


See Also 


acctcon(C), login(M), who(C), write(C) 
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